> ## 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. # Submit KYC Data > Submit identity (KYC) data you have already collected for the applicant, with their consent. Verification runs server-side; the applicant does not need to complete a verification link. The result is usually available asynchronously: poll the application status endpoint for the final `kyc_status`, or subscribe to the `identity_verification.*` webhook events. Repeat submissions while a verification is in progress are idempotent and return the current status without re-sending data; corrected data is applied on a new submission after the current attempt completes or fails. ## OpenAPI ````yaml POST /partner/applications/{app_id}/kyc 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 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: /partner/applications/{app_id}/kyc: post: tags: - Partner Onboarding summary: Submit KYC Data description: >- Submit identity (KYC) data you have already collected for the applicant, with their consent. Verification runs server-side; the applicant does not need to complete a verification link. The result is usually available asynchronously: poll the application status endpoint for the final `kyc_status`, or subscribe to the `identity_verification.*` webhook events. Repeat submissions while a verification is in progress are idempotent and return the current status without re-sending data; corrected data is applied on a new submission after the current attempt completes or fails. operationId: submit_kyc_partner_applications__app_id__kyc_post parameters: - name: app_id in: path required: true schema: type: string title: App Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PartnerKycSubmissionRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PartnerKycSubmissionResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - partner:onboarding:write components: schemas: PartnerKycSubmissionRequest: properties: first_name: type: string minLength: 1 title: First Name description: Legal first name. examples: - Felix last_name: type: string minLength: 1 title: Last Name description: Legal last name. examples: - Whiskers date_of_birth: $ref: '#/components/schemas/DateString' description: Date of birth (`YYYY-MM-DD`). id_number: anyOf: - type: string format: password writeOnly: true - type: 'null' title: Id Number description: >- Government ID number matching `id_type`. For `us_ssn` use nine digits, with or without dashes (123-45-6789 or 123456789); for `us_ssn_last_4` use the last four digits; for non-US ID types provide the number as issued. Formatting characters are stripped before verification. Required when the representative's country issues an ID type we can verify, and must be omitted when it does not (e.g. the United Kingdom, which has no supported ID type). examples: - 123-45-6789 id_type: $ref: '#/components/schemas/ExtPlaidIDNumberType' description: >- Type of government ID, which must belong to the country of the representative's `address`. Defaults to `us_ssn`; non-US representatives pass their country-specific type (e.g. `sg_nric`, `au_passport`, `ca_sin`). Ignored when the country has no supported ID type. default: us_ssn address: $ref: '#/components/schemas/OnboardingAddress' description: Residential address. phone_number: anyOf: - type: string pattern: ^\+[1-9]\d{1,14}$ - type: 'null' title: Phone Number description: Phone number in E.164 format (e.g. +14155550123). examples: - '+14155550123' ip: type: string format: ipvanyaddress title: Ip description: >- IPv4 or IPv6 address of the end user submitting this verification. Forwarded to the identity-verification provider as a fraud signal. examples: - 203.0.113.42 user_email: type: string format: email title: User Email description: >- Email address of the applicant this KYC data belongs to. Must match the `user_email` the application was created with. type: object required: - first_name - last_name - date_of_birth - address - ip - user_email title: PartnerKycSubmissionRequest PartnerKycSubmissionResponse: properties: application_id: type: string format: uuid title: Application Id description: Unique application identifier. user_email: type: string title: User Email description: Email address of the verified applicant. kyc_status: $ref: '#/components/schemas/OnboardingKycStatus' description: >- Identity verification status after this submission. Verification usually completes asynchronously; poll the application status endpoint for the final result. This polled status has no `action_required` value: attempts the `identity_verification.*` webhook stream reports as `identity_verification.action_required` appear here as `pending` until a new attempt resolves. type: object required: - application_id - user_email - kyc_status title: PartnerKycSubmissionResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError DateString: type: string format: date title: DateString description: >- ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)). ExtPlaidIDNumberType: type: string enum: - ar_dni - au_drivers_license - au_passport - br_cpf - ca_sin - cl_run - cn_resident_card - co_nit - dk_cpr - eg_national_id - es_dni - es_nie - hk_hkid - in_pan - in_epic - it_cf - jo_civil_id - jp_my_number - ke_huduma_namba - kw_civil_id - mx_curp - mx_rfc - my_nric - ng_nin - nz_drivers_license - om_civil_id - ph_psn - pl_pesel - ro_cnp - sa_national_id - se_pin - sg_nric - tr_tc_kimlik - us_ssn - us_ssn_last_4 - za_smart_id title: ExtPlaidIDNumberType x-enum-varnames: - ar_dni - au_drivers_license - au_passport - br_cpf - ca_sin - cl_run - cn_resident_card - co_nit - dk_cpr - eg_national_id - es_dni - es_nie - hk_hkid - in_pan - in_epic - it_cf - jo_civil_id - jp_my_number - ke_huduma_namba - kw_civil_id - mx_curp - mx_rfc - my_nric - ng_nin - nz_drivers_license - om_civil_id - ph_psn - pl_pesel - ro_cnp - sa_national_id - se_pin - sg_nric - tr_tc_kimlik - us_ssn - us_ssn_last_4 - za_smart_id OnboardingAddress: properties: address: type: string maxLength: 900 minLength: 1 title: Address description: Street address line 1. examples: - 9 Whisker Way address_2: anyOf: - type: string maxLength: 900 - type: 'null' title: Address 2 description: Street address line 2. examples: - Suite 9 city: type: string maxLength: 300 minLength: 1 title: City description: City name. examples: - San Francisco state: anyOf: - type: string maxLength: 300 - type: 'null' title: State description: State or province code. examples: - CA zip: type: string maxLength: 100 minLength: 1 title: Zip description: Postal or ZIP code. examples: - '94105' country: $ref: '#/components/schemas/CountryCodeAlpha2' description: ISO 3166-1 alpha-2 country code. type: object required: - address - city - zip - country title: OnboardingAddress OnboardingKycStatus: type: string enum: - not_started - pending - action_required - approved - rejected title: OnboardingKycStatus x-enum-varnames: - not_started - pending - action_required - approved - rejected 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 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 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 - 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 ````