> ## 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 representative KYC data > Submit identity (KYC) data for a representative you added. Verification runs server-side; poll the entity onboarding status endpoint for the result. Use this when you hold the representative's identity details; otherwise mint a verification link for them to self-verify. ## OpenAPI ````yaml POST /entities/{entity_id}/representatives/{representative_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: /entities/{entity_id}/representatives/{representative_id}/kyc: post: tags: - Entities summary: Submit Representative KYC Data description: >- Submit identity (KYC) data for a representative you added. Verification runs server-side; poll the entity onboarding status endpoint for the result. Use this when you hold the representative's identity details; otherwise mint a verification link for them to self-verify. operationId: >- submit_representative_kyc_data_entities__entity_id__representatives__representative_id__kyc_post parameters: - name: representative_id in: path required: true schema: type: string title: Representative Id - name: entity_id in: path required: true schema: type: string title: Entity Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OnboardingKycIdentity' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EntityRepresentativeKycResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - entity:create components: schemas: OnboardingKycIdentity: 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: type: string format: password title: Id Number description: >- Government ID number. 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. Formatting characters are stripped before verification. writeOnly: true examples: - 123-45-6789 id_type: $ref: '#/components/schemas/ExtPlaidIDNumberType' description: Type of government ID (e.g. `us_ssn`, `us_ssn_last_4`). 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' type: object required: - first_name - last_name - date_of_birth - id_number - address title: OnboardingKycIdentity EntityRepresentativeKycResponse: properties: representative_id: type: string format: uuid title: Representative Id description: ID of the representative whose KYC was submitted. kyc_status: $ref: '#/components/schemas/OnboardingKycStatus' description: >- This representative's identity verification status right after submission. It completes asynchronously; track completion via the entity's `next_step` (the identity-verification step clears) or the `identity_verification.*` webhooks. The entity's own `kyc_status` reflects the primary representative, not this representative. type: object required: - representative_id - kyc_status title: EntityRepresentativeKycResponse 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 - approved - rejected title: OnboardingKycStatus x-enum-varnames: - not_started - pending - 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 ````