> ## Documentation Index > Fetch the complete documentation index at: https://developer.meow.com/llms.txt > Use this file to discover all available pages before exploring further. # Get International Contact Requirements > Returns the fields an international contact needs before you create one, for a given currency and destination bank country. Destinations differ: some route on an IBAN, others on a domestic routing code, and some want the recipient's full address. Ask here first, then send the answer's fields as `international` on `POST /contacts`. Check `supported` before reading the fields, since not every currency reaches every country. ## OpenAPI ````yaml GET /contacts/international-requirements openapi: 3.1.0 info: title: Meow API description: > ## Overview The Meow API provides financial services and billing capabilities for your business. ### Core Features - **Financial data access**: access account information, transactions, balances, and payment networks. - **Crypto operations**: create and manage crypto contacts, and initiate USDC transfers across blockchain networks. ### Billing API The Billing API lets you create and manage invoices and collect payments: - **Product management**: create and manage products with custom pricing. - **Customer management**: maintain invoicing customers with their addresses. - **Invoice creation**: generate invoices with line items, discounts, and custom notes. - **Payment options**: accept payments via ACH, wire, international wire, card, and USDC. - **Collection accounts**: configure accounts for payment collection. ### Getting Started Authenticate by sending your API key in the `x-api-key` request header. To scope requests to a specific entity, include the `x-entity-id` header. Use the `/api-keys/accessible-entities` endpoint to list all entities accessible by your API key. ### Error Responses Errors return JSON with `code`, `message`, and `debug_message`. The `code` aligns with FDX where possible; use `debug_message` for troubleshooting only. Common error codes: - `500`: Internal server error - `501`: Subsystem unavailable - `503`: Scheduled maintenance - `601`: Data not found - `602`: Customer not authorized - `701`: Account not found - `703`: Invalid input (including invalid date ranges) - `704`: Account type not supported - `705`: Account is closed - `801`: Transaction not found contact: name: Meow url: https://meow.com/ email: support@meow.com version: 1.0.0 license: name: Proprietary url: https://www.meow.com/terms-of-service servers: - url: https://api.meow.com/v1 description: Meow API Production - url: https://api.sandbox.meow.com/v1 description: Meow API Sandbox - url: https://api.dev.meow.com/v1 description: Meow API Development security: - apiKeyAuth: [] tags: - name: API Keys description: Retrieve metadata about API keys and their accessible entities. - name: Accounts description: Access and manage accounts. - name: Approvals - name: Balances description: Retrieve account balances and available funds. - name: Bills description: View and manage bills for vendor payments. - name: Cards description: Manage virtual and physical cards, and view transactions and insights. - name: Collection Accounts description: Manage accounts for payment collection. - name: Contacts description: Manage contacts for crypto and USDC transfers. - name: Customers description: Manage invoicing customers and their details. - name: Entities - name: Invoices description: Create and manage invoices. - name: Limits - name: Line Items description: Manage invoice line items. - name: Partner Onboarding description: Onboard entities using your partner API key. - name: Partner Webhooks - name: Payment Methods description: View available payment method types. - name: Payment Networks description: Manage payment networks and routing information. - name: Products description: Manage products and pricing for invoicing. - name: Routing Numbers description: Validate routing numbers and retrieve bank information. - name: Security Policies - name: Simulations description: >- Trigger simulated events (inbound transfers, card authorizations, application approval) to test integrations end-to-end without real money movement. **Not available in production**: these endpoints exist only in sandbox and development environments and return `404 Not Found` in production. - name: Tax Forms description: Retrieve IRS tax forms (1099 family) issued for accounts. - name: Transactions description: Retrieve account transaction history and details. - name: Transfers description: >- Initiate ACH, wire, book, and crypto transfers, and retrieve transfer details. - name: Webhooks description: Manage webhook subscriptions and inspect delivery history. paths: /contacts/international-requirements: get: tags: - Contacts summary: Get International Contact Requirements description: >- Returns the fields an international contact needs before you create one, for a given currency and destination bank country. Destinations differ: some route on an IBAN, others on a domestic routing code, and some want the recipient's full address. Ask here first, then send the answer's fields as `international` on `POST /contacts`. Check `supported` before reading the fields, since not every currency reaches every country. operationId: get_international_requirements_contacts_international_requirements_get parameters: - name: recipient_currency in: query required: true schema: $ref: '#/components/schemas/Iso4217Code' description: Currency the recipient would be paid in. description: Currency the recipient would be paid in. - name: bank_country in: query required: true schema: $ref: '#/components/schemas/CountryCodeAlpha2' description: ISO 3166-1 alpha-2 country code of the recipient's bank. description: ISO 3166-1 alpha-2 country code of the recipient's bank. - name: beneficiary_country in: query required: false schema: anyOf: - $ref: '#/components/schemas/CountryCodeAlpha2' - type: 'null' description: >- ISO 3166-1 alpha-2 country code where the recipient lives or is registered. Defaults to `bank_country`. title: Beneficiary Country description: >- ISO 3166-1 alpha-2 country code where the recipient lives or is registered. Defaults to `bank_country`. - name: beneficiary_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/InternationalBeneficiaryType' - type: 'null' description: >- Whether the recipient is a person or a business. Some corridors ask for different fields for each; defaults to `company`. title: Beneficiary Type description: >- Whether the recipient is a person or a business. Some corridors ask for different fields for each; defaults to `company`. - name: payment_method in: query required: false schema: anyOf: - $ref: '#/components/schemas/InternationalPaymentMethod' - type: 'null' description: >- Narrow the answer to one network. Left off, the destination's usual network decides. title: Payment Method description: >- Narrow the answer to one network. Left off, the destination's usual network decides. - $ref: '#/components/parameters/EntityIdHeader' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/InternationalRequirements' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - contacts:read components: schemas: Iso4217Code: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BOV - BRL - BSD - BTN - BWP - BYN - BZD - CAD - CDF - CHE - CHF - CHW - CLF - CLP - CNY - COP - COU - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MXV - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SLE - SEK - SGD - SHP - SLL - SOS - SRD - SSP - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - USN - UYI - UYU - UYW - UZS - VED - VES - VND - VUV - WST - XAF - XAG - XAU - XBA - XBB - XBC - XBD - XCD - XDR - XOF - XPD - XPF - XPT - XSU - XTS - XUA - XXX - YER - ZAR - ZMW - ZWG - ZWL title: Iso4217Code CountryCodeAlpha2: type: string enum: - AW - AF - AO - AI - AX - AL - AD - AE - AR - AM - AS - AQ - TF - AG - AU - AT - AZ - BI - BE - BJ - BQ - BF - BD - BG - BH - BS - BA - BL - BY - BZ - BM - BO - BR - BB - BN - BT - BV - BW - CF - CA - CC - CH - CL - CN - CI - CM - CD - CG - CK - CO - KM - CV - CR - CU - CW - CX - KY - CY - CZ - DE - DJ - DM - DK - DO - DZ - EC - EG - ER - EH - ES - EE - ET - FI - FJ - FK - FR - FO - FM - GA - GB - GE - GG - GH - GI - GN - GP - GM - GW - GQ - GR - GD - GL - GT - GF - GU - GY - HK - HM - HN - HR - HT - HU - ID - IM - IN - IO - IE - IR - IQ - IS - IL - IT - JM - JE - JO - JP - KZ - KE - KG - KH - KI - KN - KR - KW - LA - LB - LR - LY - LC - LI - LK - LS - LT - LU - LV - MO - MF - MA - MC - MD - MG - MV - MX - MH - MK - ML - MT - MM - ME - MN - MP - MZ - MR - MS - MQ - MU - MW - MY - YT - NA - NC - NE - NF - NG - NI - NU - NL - 'NO' - NP - NR - NZ - OM - PK - PA - PN - PE - PH - PW - PG - PL - PR - KP - PT - PY - PS - PF - QA - RE - RO - RU - RW - SA - SD - SN - SG - GS - SH - SJ - SB - SL - SV - SM - SO - PM - RS - SS - ST - SR - SK - SI - SE - SZ - SX - SC - SY - TC - TD - TG - TH - TJ - TK - TM - TL - TO - TT - TN - TR - TV - TW - TZ - UG - UA - UM - UY - US - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XK - YE - ZA - ZM - ZW title: CountryCodeAlpha2 x-enum-varnames: - AW - AF - AO - AI - AX - AL - AD - AE - AR - AM - AS - AQ - TF - AG - AU - AT - AZ - BI - BE - BJ - BQ - BF - BD - BG - BH - BS - BA - BL - BY - BZ - BM - BO - BR - BB - BN - BT - BV - BW - CF - CA - CC - CH - CL - CN - CI - CM - CD - CG - CK - CO - KM - CV - CR - CU - CW - CX - KY - CY - CZ - DE - DJ - DM - DK - DO - DZ - EC - EG - ER - EH - ES - EE - ET - FI - FJ - FK - FR - FO - FM - GA - GB - GE - GG - GH - GI - GN - GP - GM - GW - GQ - GR - GD - GL - GT - GF - GU - GY - HK - HM - HN - HR - HT - HU - ID - IM - IN - IO - IE - IR - IQ - IS - IL - IT - JM - JE - JO - JP - KZ - KE - KG - KH - KI - KN - KR - KW - LA - LB - LR - LY - LC - LI - LK - LS - LT - LU - LV - MO - MF - MA - MC - MD - MG - MV - MX - MH - MK - ML - MT - MM - ME - MN - MP - MZ - MR - MS - MQ - MU - MW - MY - YT - NA - NC - NE - NF - NG - NI - NU - NL - 'NO' - NP - NR - NZ - OM - PK - PA - PN - PE - PH - PW - PG - PL - PR - KP - PT - PY - PS - PF - QA - RE - RO - RU - RW - SA - SD - SN - SG - GS - SH - SJ - SB - SL - SV - SM - SO - PM - RS - SS - ST - SR - SK - SI - SE - SZ - SX - SC - SY - TC - TD - TG - TH - TJ - TK - TM - TL - TO - TT - TN - TR - TV - TW - TZ - UG - UA - UM - UY - US - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XK - YE - ZA - ZM - ZW InternationalBeneficiaryType: type: string enum: - individual - company title: InternationalBeneficiaryType x-enum-varnames: - individual - company InternationalPaymentMethod: type: string enum: - SWIFT - LOCAL title: InternationalPaymentMethod x-enum-varnames: - SWIFT - LOCAL InternationalRequirements: properties: recipient_currency: $ref: '#/components/schemas/Iso4217Code' description: Currency the requirements were resolved for. bank_country: $ref: '#/components/schemas/CountryCodeAlpha2' description: Destination bank country the requirements were resolved for. supported: type: boolean title: Supported description: >- Whether this business can pay that currency into that country at all. When `false`, `required_fields` is empty. unsupported_reason: anyOf: - type: string - type: 'null' title: Unsupported Reason description: Why the corridor is unavailable, when `supported` is false. required_fields: items: $ref: '#/components/schemas/InternationalRequirementField' type: array title: Required Fields description: >- Every field you must supply. It is the union across the ways your accounts can fund the payment, so a contact carrying all of them is payable from any of them. type: object required: - recipient_currency - bank_country - supported - required_fields title: InternationalRequirements HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError InternationalRequirementField: properties: field: $ref: '#/components/schemas/InternationalRequirementFieldName' description: Which field of the contact's `international` details. pattern: anyOf: - type: string - type: 'null' title: Pattern description: >- Regular expression the value must match. Absent when the field is required but has no single format, which happens when two ways of funding the payment disagree on the format. fixed_value: anyOf: - type: string - type: 'null' title: Fixed Value description: >- The only value this corridor accepts for the field. Send it verbatim. type: object required: - field title: InternationalRequirementField ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError InternationalRequirementFieldName: type: string enum: - first_name - last_name - company_name - beneficiary_type - currency - address.street_line_1 - address.city - address.state - address.postal_code - address.country - bank_name - bank_country - bank_address - account_number - iban - bic_swift - routing_code_type - routing_code_value - routing_code_type_2 - routing_code_value_2 title: InternationalRequirementFieldName description: >- Field paths into the `international` object of a create or update contact request. A dotted value addresses a nested field: `address.city` is `city` inside `international.address`. x-enum-varnames: - first_name - last_name - company_name - beneficiary_type - currency - address_street_line_1 - address_city - address_state - address_postal_code - address_country - bank_name - bank_country - bank_address - account_number - iban - bic_swift - routing_code_type - routing_code_value - routing_code_type_2 - routing_code_value_2 parameters: EntityIdHeader: name: x-entity-id in: header required: false schema: type: string format: uuid description: Optional `entity_id` to scope requests to a specific entity. securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Your Meow API key, sent in the `x-api-key` header for authentication. x-scopes: - accounts:read - accounts:write - accounts:payment-networks - accounts:transactions - accounts:balances - accounts:statements - accounts:tax-documents - entity:create - transfers:crypto:write - transfers:usdc:write - transfers:ach:write - transfers:wire:write - transfers:book:write - transfers:international:write - contacts:read - contacts:write - billing:products:read - billing:products:write - billing:customers:read - billing:customers:write - billing:invoices:read - billing:invoices:write - billing:accounts:read - billpay:read - billpay:write - onboarding:read - onboarding:write - cards:read - cards:write - webhooks:read - webhooks:write - partner:onboarding:read - partner:onboarding:write - partner:webhooks:read - partner:webhooks:write - simulations:write - banking:limits:read - banking:limits:write ````