> ## 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. # Update Business Details > Update a business entity's KYB details before its application is submitted. Send only the fields you want to change; anything you omit keeps its current value. Use this to fill in the business phone, tax ID, website, description, industry, account purpose, and digital-currency questions, and the registered legal and physical addresses, or to correct details captured at creation. Send `physical_address` together with `business_address`; omitting it keeps any physical address already on file, or uses the legal address when none is set. Returns the refreshed onboarding status, including what is still required next. ## OpenAPI ````yaml PATCH /entities/{entity_id}/business-details 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}/business-details: patch: tags: - Entities summary: Update Business Details description: >- Update a business entity's KYB details before its application is submitted. Send only the fields you want to change; anything you omit keeps its current value. Use this to fill in the business phone, tax ID, website, description, industry, account purpose, and digital-currency questions, and the registered legal and physical addresses, or to correct details captured at creation. Send `physical_address` together with `business_address`; omitting it keeps any physical address already on file, or uses the legal address when none is set. Returns the refreshed onboarding status, including what is still required next. operationId: >- update_entity_business_details_entities__entity_id__business_details_patch parameters: - name: entity_id in: path required: true schema: type: string title: Entity Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EntityUpdateBusinessDetailsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EntityOnboardingStatusResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - entity:create components: schemas: EntityUpdateBusinessDetailsRequest: properties: business_phone: anyOf: - type: string maxLength: 20 minLength: 10 - type: 'null' title: Business Phone description: Business phone number. examples: - '+14155550123' business_taxid: anyOf: - type: string maxLength: 50 minLength: 0 - type: 'null' title: Business Taxid description: Business tax ID (EIN). examples: - 12-3456789 business_website: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Business Website description: Public website of the business. examples: - https://catnipcoffee.com business_description: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Business Description description: Short description of what the business does. examples: - Specialty coffee roaster and cafe industry: anyOf: - $ref: '#/components/schemas/Industry' - type: 'null' description: The industry the business operates in. account_purpose: anyOf: - $ref: '#/components/schemas/AccountPurpose' - type: 'null' description: Why the business needs the account. account_purpose_description: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Account Purpose Description description: Free-text detail for the account purpose, when relevant. provides_blockchain_or_digital_currency_services: anyOf: - type: boolean - type: 'null' title: Provides Blockchain Or Digital Currency Services description: >- Whether the business provides blockchain or digital currency services. transacts_in_digital_currency: anyOf: - type: boolean - type: 'null' title: Transacts In Digital Currency description: Whether the business transacts in digital currency. develops_governs_supports_blockchain_protocol: anyOf: - type: boolean - type: 'null' title: Develops Governs Supports Blockchain Protocol description: >- Whether the business develops, governs, or supports a blockchain protocol. business_name: anyOf: - type: string maxLength: 400 minLength: 1 - type: 'null' title: Business Name description: Legal business name. examples: - Catnip Coffee Co business_date_of_incorporation: anyOf: - $ref: '#/components/schemas/DateString' - type: 'null' description: Date the business was incorporated. incorporation_state: anyOf: - $ref: '#/components/schemas/StateCode' - type: 'null' description: State or jurisdiction of incorporation. examples: - DE legal_structure: anyOf: - $ref: '#/components/schemas/LegalStructure' - type: 'null' description: Legal structure of the business (e.g. `llc`, `corp`). business_address: anyOf: - $ref: '#/components/schemas/OnboardingAddress' - type: 'null' description: Registered legal business address. physical_address: anyOf: - $ref: '#/components/schemas/OnboardingAddress' - type: 'null' description: >- Primary operating address, sent together with `business_address`. Provide it only when it differs from the legal address; omitting it keeps a physical address already on file, or uses the legal address when none is set yet. type: object title: EntityUpdateBusinessDetailsRequest EntityOnboardingStatusResponse: properties: entity_id: type: string format: uuid title: Entity Id description: >- Public ID of the onboarded business entity, stable across the onboarding lifecycle and matching the `entity_id` used in the Customer API, MCP, and webhook payloads. status: $ref: '#/components/schemas/OnboardingApplicationStatus' description: Current onboarding status. business_name: anyOf: - type: string - type: 'null' title: Business Name description: Legal business name. created_at: $ref: '#/components/schemas/Timestamp' description: ISO 8601 timestamp of when the entity was created. updated_at: $ref: '#/components/schemas/Timestamp' description: ISO 8601 timestamp of when onboarding was last updated. documents: items: $ref: '#/components/schemas/OnboardingDocumentStatus' type: array title: Documents description: Documents uploaded during onboarding. kyc_status: $ref: '#/components/schemas/OnboardingKycStatus' description: >- Identity verification status of the entity's primary representative. After you submit KYC data or the representative completes verification, this value moves to `pending` and resolves on its own; poll it to track progress. It is coarser than the `identity_verification.*` webhooks: a verification the webhooks report as `identity_verification.action_required` shows here as `pending` until a new attempt resolves. onboarding_type: $ref: '#/components/schemas/PublicOnboardingType' description: How this entity was onboarded (e.g. `api`, `smb`, `partner`). next_step: $ref: '#/components/schemas/OnboardingNextStep' description: >- What you must do next: the current onboarding step, the items still missing for it, and whether the application is ready to be submitted for review. type: object required: - entity_id - status - business_name - created_at - updated_at - documents - kyc_status - onboarding_type - next_step title: EntityOnboardingStatusResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Industry: type: string enum: - accounting_bookkeeping - accounting_bookkeeping_tax_preparation - advertising - art - art_theater - art_painting - art_sculpting - beauty_cosmetic_services - biotech - business_management - cafeterias_grill_buffets_buffets - caterers - cleaning_services - construction - consulting - consulting_strategy - consulting_business - consulting_financial - crypto - crypto_exchange - crypto_investments - crypto_daos - crypto_nfts - crypto_mining - saas - design - design_web - design_digital - design_interior - design_fashion - drinking_places_alcoholic_beverages - ecommerce - ecommerce_amazon - ecommerce_ebay - ecommerce_shopify - education - education_university - education_financial - energy - energy_solar - energy_wind - energy_refining - energy_fuel - entertainment - entertainment_television - entertainment_film - entertainment_music - entertainment_print - financial_services - financial_services_money_services_business - financial_services_payment_processor - financial_services_fintech - financial_services_consumer_commercial_lending - fitness - food - food_restaurant_food_truck - food_manufacturing - food_service_contractors - full_service_restaurants - hardware - health_services - health_services_clinic - health_services_telehealth - health_services_holistic_services - health_services_healthcare_tech - holding - insurance - investment - investment_venture_capital - legal - legal_attorney - legal_paralegal - limited_service_restaurants - marketing - marketplace - merchant_banking - merges_and_acquisitions - mining - mobile_food_services - nonprofit - other - private_equity - professional_services - professional_services_architect - professional_services_attorney - professional_services_doctor - professional_services_engineer - professional_services_paralegal - real_estate - real_estate_short_term_rental - real_estate_development - real_estate_investing - real_estate_property_management - recruiting - research - research_medical - research_scientific - research_market - retail_wholesale - security - security_private - security_infosec - shipping_warehousing - sports_team - support_services - snack_and_nonalcoholic_beverage_bars - software - software_b2b - software_developer_tools - software_enterprise_software - technology - technology_agriculture - technology_artificial_intelligence - technology_augmented_reality - technology_community - technology_consumer - technology_drones - technology_government - technology_it_telecom - technology_robotics - technology_virtual_reality - transportation - transportation_limo_car_service - transportation_ride_share - travel - travel_agency - travel_hotel_reservations - waste_management - cannabis title: Industry AccountPurpose: type: string enum: - additional_yield - business_operations - other title: AccountPurpose 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)). StateCode: type: string enum: - AL - AK - AZ - AR - CA - CO - CT - DC - DE - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - PR title: StateCode x-enum-varnames: - AL - AK - AZ - AR - CA - CO - CT - DC - DE - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - PR LegalStructure: type: string enum: - ccorp - corp - estate - foreign_entity - llc - llp - lp - nonprofit - partnership - scheme - scorp - soleprop - trust title: LegalStructure 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 OnboardingApplicationStatus: type: string enum: - pending_document_upload - pending_user_action - submitted - under_review - approved - rejected title: OnboardingApplicationStatus Timestamp: type: string format: date-time title: Timestamp description: >- ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)). OnboardingDocumentStatus: properties: proof_type: $ref: '#/components/schemas/KybProofType' description: Type of KYB document. file_name: anyOf: - type: string - type: 'null' title: File Name description: Uploaded file name, or null if not yet uploaded. type: object required: - proof_type - file_name title: OnboardingDocumentStatus OnboardingKycStatus: type: string enum: - not_started - pending - approved - rejected title: OnboardingKycStatus x-enum-varnames: - not_started - pending - approved - rejected PublicOnboardingType: type: string enum: - api - smb - mcp - partner title: PublicOnboardingType x-enum-varnames: - api - smb - mcp - partner OnboardingNextStep: properties: step: $ref: '#/components/schemas/OnboardingStep' description: The onboarding step the application is currently on. phase: $ref: '#/components/schemas/OnboardingPhase' description: >- Coarse onboarding phase (collecting info, ready to submit, or submitted). missing: items: type: string type: array title: Missing description: >- Items you still need to provide to advance past the current step. Empty once the step is satisfied. required_proof_types: items: $ref: '#/components/schemas/KybProofType' type: array title: Required Proof Types description: >- KYB documents the entity still owes, as `proof_type` values. Pass each one as the `proof_type` when requesting a document upload URL. Empty once every required document is on file. can_submit: type: boolean title: Can Submit description: >- Whether all requirements are met and the application is ready to be submitted for review. type: object required: - step - phase - missing - can_submit title: OnboardingNextStep 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 KybProofType: type: string enum: - accredited - address - articles_of_organization - bank_statement - client_contract - client_invoice - beneficial_owner_address - beneficial_owner_id - beneficial_owner_id_back - beneficial_ownership_register - bylaws - certificate_of_good_standing - corporate_resolution - drivers_license - due_diligence - ein - final_edd_report - government_issued_business_license - hemp_cultivator_state_license - incorporation - industry_related_license - lease_agreement - llc_resolution - money_service_business_license - money_transmitter_registration - mortgage_statement - national_id - org_chart - partnership_agreement - partnership_agreement_due_diligence - partnership_resolution - personal_address - remote_employees_due_diligence - signed_ss4 - tax_exemption_certificate - uk_officer_passport - uk_officer_registry - uk_registry - uk_shareholder_registry - uk_w8_en - utility_bill - us_based_office_proof_of_address_due_diligence - pitch_deck - active_business_registration - proof_of_ownership_or_banking_authorization - non_profit_bylaws - operating_agreement - flow_of_funds - aml_sanction - registration_or_license - sec_filing - legal_opinion - certificate_of_formation_master_llc - series_operating_agreement - share_subscription_agreement - fund_subscription_agreement - safe_agreement - convertible_note_agreement - loan_promissory_note - token_purchase_agreement - saft_agreement - deal_memo_hybrid_agreement - issuer_due_diligence_report - protocol_ecosystem_questionnaire - investment_company_due_diligence_form - us_based_operations_due_diligence_form - register_of_directors - articles_of_association - memorandum_of_association - non_profit_status - ofac_sanctions_screening_policy - aml_kyc_policy - w8_bene - corporate_structure_chart - sanctions_vendor_service_agreement - contractual_fund_flow_agreements title: KybProofType OnboardingStep: type: string enum: - gather_business_context - collect_user_info - collect_business_addresses - collect_business_details - collect_additional_details - complete_due_diligence - upload_documents - manage_representatives - complete_identity_verification - accept_terms - submit_application - monitor_review - resolve_info_requests title: OnboardingStep OnboardingPhase: type: string enum: - business_info - ready_to_submit - submitted title: OnboardingPhase 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 ````