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.
Authorizations
Your Meow API key, sent in the x-api-key header for authentication.
Path Parameters
Body
Business phone number.
10 - 20"+14155550123"
Business tax ID: the EIN for US businesses, or the local registration/tax number elsewhere (e.g. UEN in Singapore, UTR in the UK).
50"12-3456789"
Public website of the business.
400"https://catnipcoffee.com"
Short description of what the business does.
400"Specialty coffee roaster and cafe"
Description of the source of the business's assets. Required before submitting an application that requests stablecoins.
400"Operating revenue"
The industry the business operates in.
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 Why the business needs the account.
additional_yield, business_operations, other Free-text detail for the account purpose, when relevant.
400Whether the business provides blockchain or digital currency services.
Whether the business transacts in digital currency.
Whether the business develops, governs, or supports a blockchain protocol.
Legal business name.
1 - 400"Catnip Coffee Co"
Date the business was incorporated.
US state of incorporation. Required for businesses incorporated in the US; omit for businesses incorporated elsewhere.
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 "DE"
Legal structure of the business (e.g. llc, corp). Businesses incorporated outside the US use foreign_entity.
ccorp, corp, estate, foreign_entity, llc, llp, lp, nonprofit, partnership, scheme, scorp, soleprop, trust Registered legal business address. Must be in a country where Meow supports business onboarding; unsupported countries are rejected with the full supported list.
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.
Response
Successful Response
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.
Current onboarding status.
pending_document_upload, pending_user_action, submitted, under_review, approved, rejected Legal business name.
ISO 8601 timestamp of when the entity was created.
ISO 8601 timestamp of when onboarding was last updated.
Documents uploaded during onboarding.
Identity verification status of the primary representative. After you submit KYC data or they complete verification, this moves to pending and resolves on its own; poll it to track progress. action_required means their verification needs another step from them (for example, a document): create a link with POST /entities/{entity_id}/representatives/{representative_id}/verification-link and share it so they can finish. See representatives for every representative's status.
not_started, pending, action_required, approved, rejected How this entity was onboarded (e.g. api, smb, partner).
api, smb, mcp, partner 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.
Every representative on the application with their identity verification (KYC) status. The top-level kyc_status reflects the primary representative; the application can only be approved once every representative is approved.
Link where the primary representative reviews and accepts the required agreements and disclosures in their browser. Populated once the application has been submitted; share it with the primary representative. The link needs no login and anyone holding it can accept on the business's behalf, so treat it as a secret.
Progress through the agreements at consent_url. Populated alongside it once the application has been submitted. Consent is collected in parallel with review, so status moves to under_review on submission whether or not these are accepted. Poll this field, not status, to see whether the primary representative still owes anything.