title: Incorporation source_url: /developer-api/v1/incorporation summary: Approved private-preview partners can form a US LLC or, when separately enabled, a C-Corp through Ramp's incorporation provider and track the formation to completion. This workflow requires a Ramp-enabled agent-led application flow and a financing application submitted for review. content: Approved private-preview partners can form a US LLC or, when separately enabled, a C-Corp through Ramp's incorporation provider and track the formation to completion. This workflow requires a Ramp-enabled agent-led application flow and a financing application submitted for review. Private preview only Incorporation is not generally available and is not included in the public API reference. Ramp must explicitly enable both your incorporation access and an eligible agent client before you can use this workflow. Standard public application integrations cannot initiate incorporation, and the endpoints return 404 when incorporation access is disabled. Contact your Ramp representative to request access and onboarding instructions. A partner-led company-formation flow: Look up the reference data the provider needs — supported countries, states, and NAICS industry codes. Create an applicant for the business. Submit an LLC formation using the submitted financing application as the source of business, ownership, responsible-party, address, and tax details. Poll company status until the formation is approved. Retrieve the formation documents. Private-preview access: Ramp must enable the incorporation rollout and configure an eligible agent client for your integration. Public application clients and standard application-creation requests do not support this workflow. Scopes: After Ramp approves and enables access, use incorporation:read for reference data, applicant lookup, status, and documents; use incorporation:write to create an applicant or submit a formation. An applicant must exist and the financing application must be submitted for review before you submit a formation. SSN is never sent to this API The formation endpoint does not accept full SSNs. Required tax-identifier details come from the submitted financing application and are handled server-side. Two actors plus the provider: your platform, the Ramp API, and the incorporation provider (brokered by Ramp). Implementation Three read endpoints supply the values the formation request must reference: GET /developer/v1/incorporation/countries — supported countries for applicant nationality / residence (ISO 3166-1 alpha-2 codes). GET /developer/v1/incorporation/states — US states available for formation, each with an abbreviation and name. GET /developer/v1/incorporation/industries?search= — NAICS industry codes, optionally filtered by a case-insensitive substring over the code or label. POST /developer/v1/incorporation/applicant with the business's country of residence. The applicant's name and email come from the authenticated business context, so the body is just: The call is idempotent per business: a 201 means the applicant was created, a 200 means it already existed (already_existed: true) — no duplicate is made. POST /developer/v1/incorporation/formation. The submitted financing application supplies the business, owners, responsible party, addresses, and tax details. You can optionally provide state to override or complete the application data. For LLC formations, you can also optionally provide one or more name_options; C-Corp formations require a nonempty name_options list. A request naics_code is used only when the financing application does not already contain a NAICS code; an existing application value always takes precedence. If you provide explicit LLC members, their ownership percentages must sum to 100. If the submitted financing application does not identify any owners, include the optional members field with ownership percentages totaling 100: entity_type defaults to LLC. When C-Corp formation is enabled, use "entity_type": "CCorp" and provide the required name_options, executive_members, and ccorp_valuation fields. Include at least one name option, even if the financing application already has a business name. A 201 returns the provider company id and the submission status: Safe to retry Submissions are idempotent per business and attempt. A failed submit persists its attempt count so the next retry uses a fresh idempotency key. GET /developer/v1/incorporation/company-status returns the live status from the provider and refreshes Ramp's cached copy: Status Meaning NOT_SUBMITTED Not yet submitted to the provider. SUBMITTED Filed with the state and waiting for an EIN. Available when pre-EIN onboarding is enabled; the response also includes pre_ein access details. PENDING_REVIEW Submitted; under provider review. APPROVED Approved; the company is formed. REJECTED Rejected — see last_rejection_reason. GET /developer/v1/incorporation/documents lists the formation documents with freshly-signed download URLs (regenerated on every call, so don't cache them): HTTP Code When 502 DEVELOPER_INCORPORATION_PROVIDER_ERROR The provider returned an error or was unreachable. 400 DEVELOPER_INCORPORATION_FIELDS_MUTUALLY_EXCLUSIVE The approved agent-led application flow combines incorporation intent with pre-formed company fields. 409 DEVELOPER_INCORPORATION_ALREADY_FORMED The resolved business is already formed.