> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumx.io/llms.txt > Use this file to discover all available pages before exploring further. # Read a destination > This endpoint reads a destination. ## OpenAPI ````yaml /openapi/api-production.yaml get /destinations/{id} openapi: 3.1.0 info: version: 1.0.0 title: Lumx API description: >- A cross-border banking API with instant settlements and unmatched liquidity, powered by stablecoins. servers: - url: https://api.lumx.io - url: https://api-sandbox.lumx.io security: [] paths: /destinations/{id}: get: tags: - Destinations summary: Read a destination description: This endpoint reads a destination. parameters: - name: id in: path required: true schema: type: string format: uuid description: Destination's unique identifier. responses: '200': description: Destination successfully retrieved. content: application/json: examples: PIX: $ref: '#/components/examples/DestinationPixExample' SWIFT: $ref: '#/components/examples/DestinationSwiftExample' SEPA: $ref: '#/components/examples/DestinationSepaExample' ACH: $ref: '#/components/examples/DestinationAchExample' FEDWIRE: $ref: '#/components/examples/DestinationFedwireExample' SPEI: $ref: '#/components/examples/DestinationSpeiExample' schema: oneOf: - type: object title: PIX description: Destination's rail is PIX. allOf: - $ref: '#/components/schemas/DestinationPixResponse' - type: object title: SWIFT description: Destination's rail is SWIFT. allOf: - $ref: '#/components/schemas/DestinationSwiftResponse' - type: object title: SEPA description: Destination's rail is SEPA. allOf: - $ref: '#/components/schemas/DestinationSepaResponse' - type: object title: ACH description: Destination's rail is ACH. allOf: - $ref: '#/components/schemas/DestinationAchResponse' - type: object title: FEDWIRE description: Destination's rail is FEDWIRE. allOf: - $ref: '#/components/schemas/DestinationFedwireResponse' - type: object title: SPEI description: Destination's rail is SPEI. allOf: - $ref: '#/components/schemas/DestinationSpeiResponse' security: - apiKey: [] components: examples: DestinationPixExample: value: id: a72f5359-ffef-6913-d1da-8g58d491g406 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx Brazil Operations Account type: EXTERNAL rail: PIX currency: BRL identifier: keyType: CNPJ keyValue: 42.887.120/0001-00 holder: type: BUSINESS relationship: SELF legalName: Lumx S.A taxId: 42.887.120/0001-00 incorporationDate: '2020-01-01' email: hello@lumx.io address: line1: Rua Voluntarios da Patria 89 city: Rio de Janeiro state: RJ postalCode: 22270-000 country: BRA verification: status: APPROVED level: BASIC createdAt: '2025-10-16T15:30:22.456Z' updatedAt: '2025-10-16T15:30:22.456Z' DestinationSwiftExample: value: id: e80d3137-eddd-4791-b9b8-6e36b289f284 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx Cayman Holdings Account type: EXTERNAL rail: SWIFT currency: USD identifier: iban: KY12BUTT00001234567890123456 bic: BUTTKYKY bank: name: Butterfield Bank (Cayman) Limited address: line1: 65 Market Street city: George Town state: Grand Cayman postalCode: KY1-1107 country: CYM holder: type: BUSINESS relationship: HOLDING_COMPANY legalName: Lumx Cayman Ltd. taxId: 123456-7 incorporationDate: '2019-01-15' email: holding@lumx.ky address: line1: Grand Pavilion, Hibiscus Way city: George Town state: Grand Cayman postalCode: KY1-1205 country: CYM verification: status: APPROVED level: BASIC intermediary: name: JP Morgan Chase Bank N.A. currency: USD bic: CHASUS33 createdAt: '2025-10-16T13:45:10.243Z' updatedAt: '2025-10-16T13:45:10.243Z' DestinationSepaExample: value: id: f91e4248-feed-5802-c0c9-7f47c390f395 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx France Subsidiary Account type: EXTERNAL rail: SEPA currency: EUR identifier: iban: FR1420041010050500013M02606 bic: BNPAFRPP bank: name: BNP Paribas address: line1: 16 Boulevard des Italiens city: Paris state: IDF postalCode: '75009' country: FRA holder: type: BUSINESS relationship: SUBSIDIARY_COMPANY legalName: Lumx SAS taxId: '98765432100015' incorporationDate: '2021-06-10' email: france@lumx.eu address: line1: 45 Avenue Montaigne city: Paris state: IDF postalCode: '75008' country: FRA verification: status: APPROVED level: BASIC createdAt: '2025-10-16T14:20:35.187Z' updatedAt: '2025-10-16T14:20:35.187Z' DestinationAchExample: value: id: b82e4359-feed-6913-d1da-9h69e502h517 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx US Operations Account type: EXTERNAL rail: ACH currency: USD identifier: type: CHECKING accountNumber: '123456789012' routingNumber: '021000021' bank: name: JPMorgan Chase Bank address: line1: 383 Madison Avenue city: New York state: NY postalCode: '10179' country: USA holder: type: BUSINESS relationship: SUBSIDIARY_COMPANY legalName: Lumx US Inc. taxId: 12-3456789 incorporationDate: '2020-03-15' email: us@lumx.io address: line1: 100 Wall Street city: New York state: NY postalCode: '10005' country: USA verification: status: APPROVED level: BASIC createdAt: '2025-10-16T16:30:45.123Z' updatedAt: '2025-10-16T16:30:45.123Z' DestinationFedwireExample: value: id: c93f5460-gffe-7024-e2eb-0i70f613i628 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx US Wire Account type: EXTERNAL rail: FEDWIRE currency: USD identifier: type: CHECKING accountNumber: '123456789012' routingNumber: '021000021' bank: name: JPMorgan Chase Bank address: line1: 383 Madison Avenue city: New York state: NY postalCode: '10179' country: USA holder: type: BUSINESS relationship: SUBSIDIARY_COMPANY legalName: Lumx US Inc. taxId: 12-3456789 incorporationDate: '2020-03-15' email: us@lumx.io address: line1: 100 Wall Street city: New York state: NY postalCode: '10005' country: USA verification: status: APPROVED level: BASIC createdAt: '2025-10-16T17:45:00.789Z' updatedAt: '2025-10-16T17:45:00.789Z' DestinationSpeiExample: value: id: d04g6571-hggf-8135-f3fc-1j81g724j739 customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: Lumx Mexico Operations Account type: EXTERNAL rail: SPEI currency: MXN identifier: clabe: '012180001234567897' bank: name: BBVA Bancomer address: line1: Paseo de la Reforma 510 city: Mexico City state: CDMX postalCode: '06600' country: MEX holder: type: BUSINESS relationship: SUBSIDIARY_COMPANY legalName: Lumx Mexico S.A. de C.V. taxId: LMX123456789 incorporationDate: '2021-06-20' email: mx@lumx.io address: line1: Avenida Insurgentes Sur 1458 city: Mexico City state: CDMX postalCode: '03900' country: MEX verification: status: APPROVED level: BASIC createdAt: '2025-10-16T18:20:30.456Z' updatedAt: '2025-10-16T18:20:30.456Z' schemas: DestinationPixResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: e80d3137-eddd-4791-b9b8-6e36b289f284 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx Destination 1 type: type: string enum: - EXTERNAL description: Destination's type. rail: type: string enum: - PIX description: Destination's payment rail. currency: type: string enum: - BRL description: Destination's currency. identifier: type: object description: Destination's identifier. properties: keyType: type: string enum: - CPF - CNPJ - EMAIL - PHONE - RANDOM description: Identifier PIX key type. example: CNPJ keyValue: type: string description: >- Identifier PIX key value. For phone keys, use E.164 international format starting with + (e.g., +5511987654321). example: 123.456.789-00 holder: type: object description: Destination's holder. properties: type: type: string enum: - BUSINESS - INDIVIDUAL description: Holder's type. example: BUSINESS relationship: type: string enum: - SELF - HOLDING_COMPANY - SUBSIDIARY_COMPANY - BRANCH_OFFICE - BUSINESS_PARTNER - SUPPLIER - CUSTOMER - CREDITOR - DEBTOR - FRANCHISEE - FRIEND - RELATIVE - EMPLOYEE description: Holder's relationship to customer. example: SELF legalName: type: string description: Holder's legal name. Required for business holders. example: Lumx S.A name: type: string description: Holder's full name. Required for individual holders. example: William Default taxId: type: string description: Holder's tax ID. example: 42.887.120/0001-00 incorporationDate: type: string format: date description: Holder's incorporation date. example: '2020-01-01' birthDate: type: string format: date description: Holder's birth date. example: '1990-01-01' email: type: string format: email description: Holder's email address. example: hello@lumx.io address: $ref: '#/components/schemas/DestinationAddress' verification: type: object description: Holder verification information. properties: status: type: string enum: - UNDER_VERIFICATION - APPROVED - TEMPORARY_REJECTION - FINAL_REJECTION description: Verification status. example: APPROVED level: type: string description: Verification level. example: BASIC createdAt: type: string format: date-time description: Creation date and time (UTC). updatedAt: type: string format: date-time description: Last update date and time (UTC). DestinationSwiftResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: e80d3137-eddd-4791-b9b8-6e36b289f284 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx Destination 1 type: type: string enum: - EXTERNAL description: Destination's type. rail: type: string enum: - SWIFT description: Destination's payment rail. currency: type: string enum: - USD - EUR description: Destination's currency. identifier: type: object description: Destination's identifier. properties: iban: type: string description: Identifier IBAN. accountNumber: type: string description: Identifier account number. bic: type: string description: Identifier BIC (SWIFT Code). bank: type: object description: Bank information. properties: name: type: string description: Bank's name. address: $ref: '#/components/schemas/DestinationAddress' description: Bank's address. holder: type: object description: Destination's holder. properties: type: type: string enum: - BUSINESS - INDIVIDUAL description: Holder's type. example: BUSINESS relationship: type: string enum: - SELF - HOLDING_COMPANY - SUBSIDIARY_COMPANY - BRANCH_OFFICE - BUSINESS_PARTNER - SUPPLIER - CUSTOMER - CREDITOR - DEBTOR - FRANCHISEE - FRIEND - RELATIVE - EMPLOYEE description: Holder's relationship to customer. example: SELF legalName: type: string description: Holder's legal name. Required for business holders. example: Lumx S.A name: type: string description: Holder's full name. Required for individual holders. example: William Default taxId: type: string description: Holder's tax ID. example: 42.887.120/0001-00 incorporationDate: type: string format: date description: Holder's incorporation date. example: '2020-01-01' birthDate: type: string format: date description: Holder's birth date. example: '1990-01-01' email: type: string format: email description: Holder's email address. example: hello@lumx.io address: $ref: '#/components/schemas/DestinationAddress' verification: type: object description: Holder verification information. properties: status: type: string enum: - UNDER_VERIFICATION - APPROVED - TEMPORARY_REJECTION - FINAL_REJECTION description: Verification status. example: APPROVED level: type: string description: Verification level. example: BASIC intermediary: type: object description: Intermediary bank information. properties: name: type: string description: Intermediary name. bic: type: string description: Intermediary BIC (SWIFT Code). country: type: string enum: - USA - GBR - DEU - FRA - NLD - ITA - ESP - IRL - LUX - BEL - SGP - HKG - JPN - CHN - IND - MYS - CAN - PAN - BHS description: Intermediary country (ISO 3166-1 alpha-3 code). createdAt: type: string format: date-time description: Creation date and time (UTC). updatedAt: type: string format: date-time description: Last update date and time (UTC). DestinationSepaResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: e80d3137-eddd-4791-b9b8-6e36b289f284 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx Destination 1 type: type: string enum: - EXTERNAL description: Destination's type. rail: type: string enum: - SEPA description: Destination's payment rail. currency: type: string enum: - EUR description: Destination's currency. identifier: type: object description: Destination's identifier. properties: iban: type: string description: Identifier IBAN. bic: type: string description: Identifier BIC (SWIFT Code). bank: type: object description: Bank information. properties: name: type: string description: Bank's name. address: $ref: '#/components/schemas/DestinationAddress' description: Bank's address. holder: type: object description: Destination's holder. properties: type: type: string enum: - BUSINESS - INDIVIDUAL description: Holder's type. example: BUSINESS relationship: type: string enum: - SELF - HOLDING_COMPANY - SUBSIDIARY_COMPANY - BRANCH_OFFICE - BUSINESS_PARTNER - SUPPLIER - CUSTOMER - CREDITOR - DEBTOR - FRANCHISEE - FRIEND - RELATIVE - EMPLOYEE description: Holder's relationship to customer. example: SELF legalName: type: string description: Holder's legal name. Required for business holders. example: Lumx S.A name: type: string description: Holder's full name. Required for individual holders. example: William Default taxId: type: string description: Holder's tax ID. example: 42.887.120/0001-00 incorporationDate: type: string format: date description: Holder's incorporation date. example: '2020-01-01' birthDate: type: string format: date description: Holder's birth date. example: '1990-01-01' email: type: string format: email description: Holder's email address. example: hello@lumx.io address: $ref: '#/components/schemas/DestinationAddress' verification: type: object description: Holder verification information. properties: status: type: string enum: - UNDER_VERIFICATION - APPROVED - TEMPORARY_REJECTION - FINAL_REJECTION description: Verification status. example: APPROVED level: type: string description: Verification level. example: BASIC createdAt: type: string format: date-time description: Creation date and time (UTC). updatedAt: type: string format: date-time description: Last update date and time (UTC). DestinationAchResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: b82e4359-feed-6913-d1da-9h69e502h517 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx US Operations Account type: type: string enum: - EXTERNAL description: Destination's type. example: EXTERNAL rail: type: string enum: - ACH description: Destination's payment rail. example: ACH currency: type: string enum: - USD description: Destination's currency. example: USD identifier: type: object description: Destination's identifier. properties: type: type: string enum: - CHECKING - SAVINGS description: Identifier account type. example: CHECKING accountNumber: type: string description: Identifier account number. example: '123456789012' routingNumber: type: string description: Identifier account routing number (ABA routing number). example: '021000021' bank: type: object description: Bank information. properties: name: type: string description: Bank's name. example: JPMorgan Chase Bank address: $ref: '#/components/schemas/DestinationAddress' description: Bank's address. holder: $ref: '#/components/schemas/DestinationHolderResponse' createdAt: type: string format: date-time description: Creation date and time (UTC). example: '2025-10-16T16:30:45.123Z' updatedAt: type: string format: date-time description: Last update date and time (UTC). example: '2025-10-16T16:30:45.123Z' DestinationFedwireResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: c93f5460-gffe-7024-e2eb-0i70f613i628 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx US Wire Account type: type: string enum: - EXTERNAL description: Destination's type. example: EXTERNAL rail: type: string enum: - FEDWIRE description: Destination's payment rail. example: FEDWIRE currency: type: string enum: - USD description: Destination's currency. example: USD identifier: type: object description: Destination's identifier. properties: type: type: string enum: - CHECKING - SAVINGS description: Identifier account type. example: CHECKING accountNumber: type: string description: Identifier account number. example: '123456789012' routingNumber: type: string description: Identifier account routing number (ABA routing number). example: '021000021' bank: type: object description: Bank information. properties: name: type: string description: Bank's name. example: JPMorgan Chase Bank address: $ref: '#/components/schemas/DestinationAddress' description: Bank's address. holder: $ref: '#/components/schemas/DestinationHolderResponse' createdAt: type: string format: date-time description: Creation date and time (UTC). example: '2025-10-16T17:45:00.789Z' updatedAt: type: string format: date-time description: Last update date and time (UTC). example: '2025-10-16T17:45:00.789Z' DestinationSpeiResponse: type: object properties: id: type: string format: uuid description: Destination's unique identifier. example: d04g6571-hggf-8135-f3fc-1j81g724j739 customerId: type: string description: Customer's unique identifier. format: uuid example: 3c90c3cc-0d44-4b50-8888-8dd25736052a name: type: string description: Destination's display name. example: Lumx Mexico Operations Account type: type: string enum: - EXTERNAL description: Destination's type. example: EXTERNAL rail: type: string enum: - SPEI description: Destination's payment rail. example: SPEI currency: type: string enum: - MXN description: Destination's currency. example: MXN identifier: type: object description: Destination's identifier. properties: clabe: type: string description: >- Identifier CLABE (Clave Bancaria Estandarizada) - 18-digit standardized bank account number. example: '012180001234567897' pattern: ^[0-9]{18}$ holder: holder: null type: object description: Destination's holder. properties: type: type: string enum: - BUSINESS - INDIVIDUAL description: Holder's type. example: BUSINESS relationship: type: string enum: - SELF - HOLDING_COMPANY - SUBSIDIARY_COMPANY - BRANCH_OFFICE - BUSINESS_PARTNER - SUPPLIER - CUSTOMER - CREDITOR - DEBTOR - FRANCHISEE - FRIEND - RELATIVE - EMPLOYEE description: Holder's relationship to customer. example: SELF legalName: type: string description: Holder's legal name. Required for business holders. example: Lumx S.A name: type: string description: Holder's full name. Required for individual holders. example: William Default taxId: type: string description: Holder's tax ID. example: 42.887.120/0001-00 incorporationDate: type: string format: date description: Holder's incorporation date. example: '2020-01-01' birthDate: type: string format: date description: Holder's birth date. example: '1990-01-01' email: type: string format: email description: Holder's email address. example: hello@lumx.io address: $ref: '#/components/schemas/DestinationAddress' verification: type: object description: Holder verification information. properties: status: type: string enum: - UNDER_VERIFICATION - APPROVED - TEMPORARY_REJECTION - FINAL_REJECTION description: Verification status. example: APPROVED level: type: string description: Verification level. example: BASIC createdAt: type: string format: date-time description: Creation date and time (UTC). example: '2025-10-16T18:20:30.456Z' updatedAt: type: string format: date-time description: Last update date and time (UTC). example: '2025-10-16T18:20:30.456Z' DestinationAddress: type: object description: Holder's address. properties: line1: type: string description: Address line 1. example: 123 Main Street line2: type: string description: Address line 2. example: Apt 4B city: type: string description: Address city. example: Frankfurt state: type: string description: Address state. example: HE postalCode: type: string description: Address postal code. example: '60311' country: type: string description: Address country code (ISO 3166-1 alpha-3). example: DEU required: - line1 - city - state - postalCode - country DestinationHolderResponse: type: object description: Destination's holder. properties: type: type: string enum: - BUSINESS - INDIVIDUAL description: Holder's type. example: BUSINESS relationship: type: string enum: - SELF - HOLDING_COMPANY - SUBSIDIARY_COMPANY - BRANCH_OFFICE - BUSINESS_PARTNER - SUPPLIER - CUSTOMER - CREDITOR - DEBTOR - FRANCHISEE - FRIEND - RELATIVE - EMPLOYEE description: Holder's relationship to customer. example: SELF name: type: string description: Holder name. example: John Doe address: $ref: '#/components/schemas/DestinationAddress' securitySchemes: apiKey: type: http scheme: bearer description: Bearer authentication header on the format `Bearer `. ````