> ## Documentation Index > Fetch the complete documentation index at: https://docs.hifi.com/llms.txt > Use this file to discover all available pages before exploring further. # List all onramps > Returns a list of onramps associated with a user under your organization. The onramps are returned sorted by creation date, with the most recent onramps appearing first. ## OpenAPI ````yaml https://production.hifi.com/api/v2/openapi.json get /v2/onramps openapi: 3.0.0 info: title: Hifi API version: 2.0.0 description: API documentation for Hifi servers: - url: https://production.hifibridge.com description: Production server - url: https://sandbox.hifibridge.com description: Sandbox server security: - bearerAuth: [] tags: - name: Common description: Common endpoints - name: User description: User endpoints - name: Kyc description: Kyc endpoints - name: Wallet description: Wallet endpoints - name: Account description: Account endpoints - name: External Account description: External Account endpoints for managing beneficiary bank accounts - name: Fiat Account description: Fiat Account endpoints - name: Virtual Account description: Virtual Account endpoints - name: Onramp description: Onramp endpoints - name: Offramp description: Offramp endpoints - name: Orchestration Address description: >- Orchestration Address endpoints — persistent on-chain wallets that automatically off-ramp incoming stablecoin deposits to a USD bank account - name: Crypto Transfer description: Crypto Transfer endpoints - name: Cross-Chain Bridge description: Cross-Chain Bridge endpoints - name: Token Swap description: Token Swap endpoints - name: Canton Offers description: Canton Offers endpoints - name: Transfer Rules description: Transfer approval rules and configuration - name: Transfer Approvals description: Transfer approval workflow and admin actions - name: File description: File endpoints - name: Reporting description: Reporting and metrics endpoints paths: /v2/onramps: get: tags: - Onramp summary: List all onramps description: > Returns a list of onramps associated with a user under your organization. The onramps are returned sorted by creation date, with the most recent onramps appearing first. parameters: - $ref: '#/components/parameters/UserIdOptionalParameter' - $ref: '#/components/parameters/LimitParameter' - $ref: '#/components/parameters/CreatedBeforeParameter' - $ref: '#/components/parameters/CreatedAfterParameter' responses: '200': $ref: '#/components/responses/FiatToCryptoAllRecordsResponse' '401': $ref: '#/components/responses/UnauthorizedResponse' '404': $ref: '#/components/responses/NotFoundResponse' '500': $ref: '#/components/responses/InternalServerErrorResponse' components: parameters: UserIdOptionalParameter: name: userId in: query schema: type: string description: The user ID. required: false LimitParameter: name: limit in: query schema: type: string minimum: 1 maximum: 100 description: default to 10, maximum to 100 required: false CreatedBeforeParameter: name: createdBefore in: query schema: type: string format: date description: 'ISO format: YYYY-MM-DD' required: false CreatedAfterParameter: name: createdAfter in: query schema: type: string format: date description: 'ISO format: YYYY-MM-DD' required: false responses: FiatToCryptoAllRecordsResponse: description: Success content: application/json: schema: $ref: '#/components/schemas/OnrampAllRecordsObject' examples: OnrampObjectListExample: $ref: '#/components/examples/OnrampObjectListExample' UnauthorizedResponse: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' NotFoundResponse: description: Resource not found content: application/json: schema: type: object properties: status: type: string enum: - error error: type: object properties: code: type: string message: type: string InternalServerErrorResponse: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' schemas: OnrampAllRecordsObject: type: object properties: count: type: integer records: type: array items: $ref: '#/components/schemas/OnrampRecordObject' nextCursor: type: string description: >- The `createdAt` timestamp of the last record in the current page. Pass this as `createdBefore` in the next request to retrieve the next page of results. Unauthorized: type: object properties: code: type: integer description: Error code error: type: string description: Error type errorDetails: type: string description: Detailed error message InternalServerError: type: object properties: code: type: integer description: Error code error: type: string description: Error type errorDetails: type: string description: Detailed error message OnrampRecordObject: $ref: '#/components/schemas/OnrampObject' OnrampObject: type: object properties: transferType: type: string transferDetails: type: object properties: id: type: string format: uuid requestId: type: string format: uuid createdAt: type: string format: date-time updatedAt: type: string format: date-time status: $ref: '#/components/schemas/OnrampStatusEnum' failedReason: type: string error: type: string description: > Error code when the onramp transaction has failed (e.g. `INTERNAL_ERROR`, `EXPIRED`, `AMOUNT_TOO_LOW`, `TRANSACTION_REJECTED`). Present when status is a failed state such as `FIAT_FAILED`, `CRYPTO_FAILED`, or `QUOTE_FAILED`. errorDetails: type: string description: > Human-readable error details when the onramp transaction has failed. Present when status is a failed state. source: type: object properties: userId: type: string format: uuid currency: type: string amount: type: number format: float accountId: type: string user: type: object properties: email: type: string lastName: type: string firstName: type: string businessName: type: string bankInfo: $ref: '#/components/schemas/InboundObject' destination: type: object properties: userId: type: string format: uuid currency: type: string chain: type: string walletAddress: type: string externalWalletId: type: string amount: type: number format: float user: type: object properties: email: type: string lastName: type: string firstName: type: string businessName: type: string receipt: type: object properties: transactionHash: type: string developerFee: type: object quoteInformation: type: object properties: sendGross: type: object properties: amount: type: string currency: type: string sendNet: type: object properties: amount: type: string currency: type: string railFee: type: object properties: amount: type: string currency: type: string receiveGross: type: object properties: amount: type: string currency: type: string receiveNet: type: object properties: amount: type: string currency: type: string rate: type: string expiresAt: type: string format: date-time depositInfo: $ref: '#/components/schemas/OnrampDepositInfoObject' OnrampStatusEnum: type: string enum: - NOT_INITIATED - CREATED - OPEN_QUOTE - FIAT_INITIATED - AWAITING_FUNDS - FIAT_PENDING - FIAT_PROCESSED - CRYPTO_INITIATED - CRYPTO_PENDING - COMPLETED - FIAT_FAILED - FIAT_RETURNED - CRYPTO_FAILED - QUOTE_FAILED - EXPIRED - CANCELLED - UNKNOWN description: > Refer to [here](https://docs.hifi.com/docs/transfers/onramps#transaction-status) for more details on each onramp status. InboundObject: type: object properties: bankName: type: string senderName: type: string routingNumber: type: string accountNumber: type: string accountType: type: string fedBatchId: type: string imad: type: string omad: type: string traceNumber: type: string bankAddress: type: string description: type: string paymentRail: type: string enum: - ach - wire - rtp OnrampDepositInfoObject: type: object properties: bankName: type: string bankAddress: type: string swiftCode: type: string beneficiary: type: object properties: name: type: string address: type: string ach: type: object properties: routingNumber: type: string accountNumber: type: string wire: type: object properties: routingNumber: type: string accountNumber: type: string rtp: type: object properties: routingNumber: type: string accountNumber: type: string reference: type: string depositBy: type: string format: date-time instruction: type: string examples: OnrampObjectListExample: summary: Onramp Object List value: count: 1 records: - transferType: ONRAMP transferDetails: id: b26927e6-2771-423c-af44-a3c7a3e815c5 requestId: e1047def-6942-4fd7-be04-e62eb41813b6 createdAt: '2025-02-03T17:15:31.927121+00:00' updatedAt: '2025-02-03T17:15:35.882+00:00' status: FIAT_PENDING failedReason: null source: userId: c15c0adf-3e45-4a62-b334-73aeec127649 currency: usd amount: 10 accountId: null user: email: example@hifibridge.com lastName: Wu firstName: Henry businessName: null bankInfo: bankName: Bank of America beneficiaryName: Henry Wu description: '' routingNumber: '026009593' referenceNumber: HFD70579F imad: '' omad: '' bankAddress: 100 N Tryon St, Charlotte, NC 28202, USA destination: userId: c15c0adf-3e45-4a62-b334-73aeec127649 currency: usdc chain: POLYGON walletAddress: '0x848732f6c834E05b17C56fa01E83EE095f72C3c3' externalWalletId: null amount: null user: email: example@hifibridge.com lastName: Wu firstName: Henry businessName: null receipt: transactionHash: null developerFee: null virtualAccountId: null quoteInformation: sendGross: amount: '10.00' currency: usd sendNet: amount: '10.00' currency: usd railFee: amount: '0.00' currency: usdc receiveGross: amount: '10.00' currency: usdc receiveNet: amount: '10.00' currency: usdc rate: '1.00' expiresAt: N/A depositInfo: bankName: Bank of NoWhere bankAddress: 123 Main St, New York, NY 10001, USA beneficiary: name: Henry Wu address: Example St 1., Apt 123, New York, NY, 10010, US ach: routingNumber: '028000024' accountNumber: '123456789' wire: routingNumber: '021000021' accountNumber: '123456789' rtp: routingNumber: '021000021' accountNumber: '123456789' reference: HFD70579F depositBy: '2025-10-04T04:23:40.229Z' instruction: >- Please deposit only one payment with the exact amount of usd and the reference code HFD70579F to the designated bank account by 2025-10-04T04:23:40.229Z. Missing or incorrect reference codes, discrepancies in the amount, or additional payments may result in the funds being lost. Ensure that the beneficiary name matches the provided account holder name, otherwise the payment may be rejected. nextCursor: '2025-02-03T17:15:31.927121+00:00' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````