> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 1. Create an Account

> Create a sub-merchant account using Razorpay Onboarding APIs.

Available in
🇮🇳 India

[Create an Account](https://razorpay.com/docs/api/partners/accounts/create.md) always makes a new account, so a new sub-merchant takes one call. One owner can have several accounts on your platform, such as one per store. An earlier attempt may also have stopped partway.

Listing is optional. If you store the account IDs you create, fetch or update an account by its ID directly. To let the sub-merchant continue an account started earlier, [find it first](#1-1-find-an-existing-account).

## 1.1 Find an Existing Account

Call [Fetch Accounts](https://razorpay.com/docs/api/partners/accounts/fetch.md) with the owner's email or phone. The list returns accounts mapped to your app, newest first. It includes accounts that are not activated yet and ones only partly filled in. Accounts on other platforms, or with Razorpay directly, never appear. An email or phone with no account returns `count: 0`, not an error.

The sub-merchant then chooses one of these:

* **Continue an existing account:** Use its `id`, [fetch the account](https://razorpay.com/docs/partners/aggregators/onboarding-api/product-status.md#7-1-fetch-the-account) and [update it](https://razorpay.com/docs/partners/aggregators/onboarding-api/submit-information.md) against its requirements.
* **Start a new account:** [Create one](#1-2-create-an-account).

`GET /v1/accounts`

```bash Curl theme={null}
curl -X GET "https://api.razorpay.com/v1/accounts?email=gaurav.kumar@example.com" \
-u rzp_test_partner_[CLIENT_ID]:[CLIENT_SECRET]
```

```json Response theme={null}
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "acc_TcdGEzmfKQzEl1",
      "country": "IN",
      "statement_descriptor": {
        "value": "Acme Corp",
        "verification": {
          "status": "verified",
          "verified_at": 1792433135
        }
      },
      "is_mfa_enabled": false,
      "user": {
        "role": "owner",
        "email": "gaurav.kumar@example.com",
        "phone": "+919611752201",
        "name": "Gaurav Kumar",
        "is_email_verified": true,
        "is_phone_verified": true
      },
      "business_profile": {
        "business_type": "individual",
        "business_name": "GAURAV KUMAR",
        "date_of_establishment": null,
        "identity_numbers": {},
        "documents": {},
        "business_category": null,
        "authorized_person": {
          "name": "GAURAV KUMAR",
          "identity_numbers": {
            "individual_pan": {
              "type": "individual_pan",
              "value": "ABCPD1234A",
              "verification": {
                "status": "verified",
                "error_code": null,
                "error_description": null,
                "verified_at": 1792433290,
                "metadata": {},
                "created_at": 1792433290
              },
              "metadata": {},
              "is_skipped": false,
              "created_at": 1792433280,
              "updated_at": 1792433290
            },
            "individual_ckyc": {
              "type": "individual_ckyc",
              "value": null,
              "verification": {
                "status": "verified",
                "error_code": null,
                "error_description": null,
                "verified_at": 1792433340,
                "metadata": {},
                "created_at": 1792433340
              },
              "metadata": {
                "ckyc_mobile": "+919845098450"
              },
              "is_skipped": false,
              "created_at": 1792433340,
              "updated_at": 1792433340
            }
          },
          "documents": {
            "aadhaar_front": {
              "id": "file_Hx7Ui2kQe9Zf3A",
              "type": "aadhaar_front",
              "url": "https://files.razorpay.com/documents/file_Hx7Ui2kQe9Zf3A",
              "metadata": {
                "source": "ckyc",
                "file_name": "aadhaar-front.jpg",
                "mime_type": "image/jpeg",
                "size_bytes": 187342
              },
              "verification": {
                "status": "verified",
                "error_code": null,
                "error_description": null,
                "verified_at": 1792433340,
                "metadata": {},
                "created_at": 1792433340
              },
              "created_at": 1792433340
            }
          },
          "address": null,
          "date_of_birth": null,
          "additional_data": {},
          "created_at": 1792433280,
          "updated_at": 1792433340
        },
        "stakeholders": {},
        "addresses": [],
        "metadata": {}
      },
      "bank_accounts": {
        "settlements_primary": {
          "type": "settlements_primary",
          "account_number": "001234567890",
          "routing_code": "ICIC0000009",
          "routing_code_type": "IFSC",
          "supporting_document": null,
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792435025,
            "metadata": {},
            "created_at": 1792435011
          }
        }
      },
      "products": {
        "payment_gateway": {
          "type": "payment_gateway",
          "status": "in_progress",
          "status_reason": null,
          "created_at": 1792433135,
          "updated_at": 1792435025,
          "requirements": [
            {
              "id": "req_7zAE2YmS5MDUhG",
              "requirement_code": "business_category",
              "requirement_level": "mandatory",
              "requirement_type": "input",
              "description": "Select your business category, and send its subcategory with it.",
              "field_path": "business_profile.business_category.category",
              "value_type": "enum",
              "options": [
                {
                  "label": "Ecommerce",
                  "value": "ecommerce"
                },
                {
                  "label": "Food and beverage",
                  "value": "food"
                }
              ],
              "status": "created"
            },
            {
              "id": "req_0HAQYzBrDRNnEM",
              "requirement_code": "accept_terms_of_service",
              "requirement_level": "mandatory",
              "requirement_type": "composite",
              "description": "Show the sub-merchant Razorpay's terms of service and record their acceptance.",
              "fulfillment_criteria": "all_of",
              "sub_requirements": [
                {
                  "id": "req_CTW6xxsQmygIDU",
                  "requirement_code": "acceptance_ip",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "The IP address the terms were accepted from.",
                  "field_path": "products.payment_gateway.terms_of_service_acceptance.ip",
                  "value_type": "text",
                  "status": "created"
                },
                {
                  "id": "req_gXg6igx2STKrZA",
                  "requirement_code": "acceptance_device_fingerprint_id",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "The device fingerprint of the device the terms were accepted on.",
                  "field_path": "products.payment_gateway.terms_of_service_acceptance.device_fingerprint_id",
                  "value_type": "text",
                  "status": "created"
                }
              ],
              "status": "created"
            }
          ],
          "terms_of_service_acceptance": null,
          "payment_channels": {
            "website": {
              "primary": "https://www.example.com",
              "additional": [],
              "verification": {
                "status": "verified",
                "error_code": null,
                "error_description": null,
                "verified_at": 1792433250,
                "metadata": {},
                "created_at": 1792433220
              }
            },
            "app_android": null,
            "app_ios": null
          },
          "clarification_responses": {}
        }
      },
      "notes": {
        "shop_id": "60291847"
      },
      "created_at": 1792433135,
      "updated_at": 1792435025
    }
  ]
}
```

> [accordion] Query Parameters
>
> Every query parameter is an optional filter. Send the owner's `email` or `phone` to find their accounts.
>
> `email` *optional*
> : `string` Return only the accounts with this user email. For example, `gaurav.kumar@example.com`.
>
> `phone` *optional*
> : `string` Return only the accounts with this user phone, +91 followed by 10 digits. For example, `+919611752201`.
>
> `product` *optional*
> : `string` Return only accounts holding this product. Possible values: `payment_gateway`, `pos`, `billing`, `business_banking`, `payroll`, `agent_studio` and `optimizer`.
>
> `from` *optional*
> : `integer` Return accounts created at or after this time, as a Unix timestamp in seconds.
>
> `to` *optional*
> : `integer` Return accounts created at or before this time, as a Unix timestamp in seconds.
>
> `count` *optional*
> : `integer` Number of accounts to return, from 1 to 100. Defaults to 10.
>
> `skip` *optional*
> : `integer` Number of accounts to skip. Defaults to 0.

## 1.2 Create an Account

Create the account with its `country` and its `user`'s email, phone and name. Name the product to onboard to in `products`, keyed by type.

Razorpay verifies the email and phone with a One-Time Password (OTP). Each unverified contact shows up straight away as a `send_phone_otp` or `send_email_otp` action requirement, next to `business_type`. Running the action returns the `phone_otp` or `email_otp` requirement, and you send the code back in an update. Know more about [verification actions](https://razorpay.com/docs/partners/aggregators/onboarding-api/verification-actions.md).

`POST /v1/accounts`

```bash Curl theme={null}
curl -X POST https://api.razorpay.com/v1/accounts \
-u rzp_test_partner_[CLIENT_ID]:[CLIENT_SECRET] \
-H "Content-Type: application/json" \
-H "X-Idempotency-Key: [UNIQUE_KEY]" \
-d '{
  "user": {
    "email": "gaurav.kumar@example.com",
    "phone": "+919611752201",
    "name": "Gaurav Kumar"
  },
  "country": "IN",
  "products": {
    "payment_gateway": {
      "payment_channels": {}
    }
  },
  "notes": {
    "shop_id": "60291847"
  }
}'
```

```json Response theme={null}
{
  "id": "acc_TcdGEzmfKQzEl1",
  "country": "IN",
  "statement_descriptor": null,
  "is_mfa_enabled": false,
  "user": {
    "role": "owner",
    "email": "gaurav.kumar@example.com",
    "phone": "+919611752201",
    "name": "Gaurav Kumar",
    "is_email_verified": true,
    "is_phone_verified": false
  },
  "business_profile": {
    "business_type": null,
    "business_name": null,
    "date_of_establishment": null,
    "identity_numbers": {},
    "documents": {},
    "business_category": null,
    "authorized_person": null,
    "stakeholders": {},
    "addresses": [],
    "metadata": {}
  },
  "bank_accounts": {},
  "products": {
    "payment_gateway": {
      "type": "payment_gateway",
      "status": "in_progress",
      "status_reason": null,
      "created_at": 1792433135,
      "updated_at": 1792433135,
      "requirements": [
        {
          "id": "req_tdJEzqip4njfe1",
          "requirement_code": "business_type",
          "requirement_level": "mandatory",
          "requirement_type": "input",
          "description": "Select the type of your business.",
          "field_path": "business_profile.business_type",
          "value_type": "enum",
          "options": [
            {
              "label": "Individual (unregistered)",
              "value": "individual"
            },
            {
              "label": "Proprietorship",
              "value": "proprietorship"
            },
            {
              "label": "Private limited",
              "value": "private_limited"
            },
            {
              "label": "Public limited",
              "value": "public_limited"
            },
            {
              "label": "Section 8 company",
              "value": "section_8_company"
            },
            {
              "label": "LLP",
              "value": "llp"
            },
            {
              "label": "Partnership",
              "value": "partnership"
            },
            {
              "label": "Trust",
              "value": "trust"
            },
            {
              "label": "Society",
              "value": "society"
            },
            {
              "label": "HUF",
              "value": "huf"
            },
            {
              "label": "Government",
              "value": "government"
            },
            {
              "label": "Judicial person",
              "value": "judicial_person"
            },
            {
              "label": "Local authority",
              "value": "local_authority"
            }
          ],
          "status": "created"
        },
        {
          "id": "req_sXPxBM8z8DFLBs",
          "requirement_code": "send_phone_otp",
          "requirement_level": "mandatory",
          "requirement_type": "action",
          "description": "Verify your mobile number with a one-time code.",
          "status": "created"
        }
      ],
      "terms_of_service_acceptance": null,
      "payment_channels": {
        "website": null,
        "app_android": null,
        "app_ios": null
      },
      "clarification_responses": {}
    }
  },
  "notes": {
    "shop_id": "60291847"
  },
  "created_at": 1792433135,
  "updated_at": 1792433135
}
```

Razorpay maps the new account to your app, and only your app can act on it.

Only `country` and `user` are mandatory in this call. The KYC fields are optional here. Each one the product needs is due before submission, and the product's `requirements` list them. A nested field marked mandatory applies only when you send its parent object.

> [accordion] Request Parameters
>
> `country` *mandatory*
> : `string` The country of the business, as an ISO 3166-1 alpha-2 code. Possible value: `IN`.
>
> `user` *mandatory*
> : `object` The person who creates and operates the account and signs in to the Razorpay Dashboard. One user can own several accounts.
>
> `user.email` *mandatory*
> : `string` The user's email address. For example, `gaurav.kumar@example.com`.
>
> `user.phone` *mandatory*
> : `string` The user's phone number, +91 followed by 10 digits. For example, `+919611752201`.
>
> `user.name` *mandatory*
> : `string` The name of the person completing the onboarding. For example, `Gaurav Kumar`.
>
> `is_mfa_enabled` *optional*
> : `boolean` Whether the owner must complete two-factor authentication on the Razorpay Dashboard.
>
> `products` *optional*
> : `object` The products to onboard to, keyed by type. For example, `"payment_gateway": { "payment_channels": {} }`.
>
> `notes` *optional*
> : `object` Key-value pairs to store your own references, such as a shop ID.

Refer to [Create an Account](https://razorpay.com/docs/api/partners/accounts/create.md) for every request parameter.

## 1.3 Create With Everything (One-Shot)

When you already have the details, send them all in the same call. This covers the business profile with its addresses, documents, authorised person and stakeholders. It also covers the bank account, the statement descriptor and the product's payment channels. Shape them all like the account itself.

Razorpay applies the values in the order onboarding needs and verifies each one. The response comes back within 5 sec. Razorpay handles the values as follows:

* **Wrong format:** A value in the wrong format fails the whole request with `400`. Razorpay creates nothing.
* **Failed verification:** Razorpay saves a well-formed value that fails verification, such as a bank name mismatch. Its `verification` shows the failure, and its requirement stays due. Fix it with an [update](https://razorpay.com/docs/partners/aggregators/onboarding-api/submit-information.md).
* **KYC record found:** A verified PAN with a Central KYC Records Registry (CKYC) record makes the `ckyc_fetch` composite requirement due. This applies to an individual, a proprietorship or the authorised person of a private limited, public limited or Section 8 company. Run `send_ckyc_otp` or skip CKYC. Know more about [fetching KYC from CKYC](https://razorpay.com/docs/partners/aggregators/onboarding-api/verification-actions.md#4-5-fetch-kyc-from-ckyc).
* **Documents as links:** Send each document as a pre-signed https link in `url`, such as an S3 pre-signed URL. Razorpay downloads it once and keeps its own copy. Links to private or internal addresses return `400 invalid_document_url`. After Create, [upload a document](https://razorpay.com/docs/partners/aggregators/onboarding-api/submit-information.md#3-6-upload-documents) and send its `id` instead. Sending a link is coming soon. Until then, [upload the file](https://razorpay.com/docs/api/partners/accounts/upload-document.md) and send its `id` with [Update an Account](https://razorpay.com/docs/api/partners/accounts/update.md).
* **Checks still running:** A check that has not finished when the response returns shows `in_progress`. Its outcome follows on the account and in the `account.requirements.updated` webhook.
* **No submission:** Create never submits the product. The sub-merchant accepts the terms once the account exists.

The example below creates an account for an individual:

`POST /v1/accounts`

```bash Curl theme={null}
curl -X POST https://api.razorpay.com/v1/accounts \
-u rzp_test_partner_[CLIENT_ID]:[CLIENT_SECRET] \
-H "Content-Type: application/json" \
-H "X-Idempotency-Key: [UNIQUE_KEY]" \
-d '{
  "user": {
    "email": "gaurav.kumar@example.com",
    "phone": "+919611752201",
    "name": "Gaurav Kumar"
  },
  "country": "IN",
  "statement_descriptor": {
    "value": "Acme Corp"
  },
  "business_profile": {
    "business_type": "individual",
    "authorized_person": {
      "identity_numbers": {
        "individual_pan": {
          "value": "ABCPD1234A"
        }
      },
      "documents": {
        "aadhaar_front": {
          "url": "https://shop-kyc.s3.ap-south-1.amazonaws.com/60291847/aadhaar-front.jpg?X-Amz-Expires=900&X-Amz-Signature=..."
        },
        "aadhaar_back": {
          "url": "https://shop-kyc.s3.ap-south-1.amazonaws.com/60291847/aadhaar-back.jpg?X-Amz-Expires=900&X-Amz-Signature=..."
        }
      }
    },
    "addresses": [
      {
        "type": "registered_address",
        "line1": "12 MG Road",
        "line2": "Indiranagar",
        "city": "Bengaluru",
        "state": "KA",
        "postal_code": "560038",
        "country": "IN"
      },
      {
        "type": "operational_address",
        "line1": "Shop 4, 80 Feet Road",
        "line2": "Koramangala",
        "city": "Bengaluru",
        "state": "KA",
        "postal_code": "560034",
        "country": "IN"
      }
    ],
    "business_category": {
      "category": "ecommerce",
      "subcategory": "fashion_and_lifestyle",
      "mcc": "5651",
      "business_description": "Clothing and accessories for men, women and children, sold online",
      "business_model_clarifications": {
        "bmc_question_2": {
          "question_id": "bmc_question_2",
          "answer": [
            "bmc_question_2_option_1"
          ]
        }
      }
    }
  },
  "bank_accounts": {
    "settlements_primary": {
      "account_number": "001234567890",
      "routing_code": "ICIC0000009",
      "routing_code_type": "IFSC"
    }
  },
  "products": {
    "payment_gateway": {
      "payment_channels": {
        "website": {
          "primary": "https://www.example.com"
        }
      }
    }
  },
  "notes": {
    "shop_id": "60291847"
  }
}'
```

```json Response theme={null}
{
  "id": "acc_TcdGEzmfKQzEl1",
  "country": "IN",
  "statement_descriptor": {
    "value": "Acme Corp",
    "verification": {
      "status": "verified",
      "verified_at": 1792433135
    }
  },
  "is_mfa_enabled": false,
  "user": {
    "role": "owner",
    "email": "gaurav.kumar@example.com",
    "phone": "+919611752201",
    "name": "Gaurav Kumar",
    "is_email_verified": true,
    "is_phone_verified": true
  },
  "business_profile": {
    "business_type": "individual",
    "business_name": "GAURAV KUMAR",
    "date_of_establishment": null,
    "identity_numbers": {},
    "documents": {},
    "business_category": {
      "category": "ecommerce",
      "subcategory": "fashion_and_lifestyle",
      "mcc": "5651",
      "business_description": "Clothing and accessories for men, women and children, sold online",
      "business_model_clarifications": {
        "bmc_question_2": {
          "question_id": "bmc_question_2",
          "question": "What is your average delivery time after receiving an order?",
          "options": [
            {
              "label": "0-7 days",
              "value": "bmc_question_2_option_1"
            },
            {
              "label": "8-14 days",
              "value": "bmc_question_2_option_2"
            },
            {
              "label": "15-21 days",
              "value": "bmc_question_2_option_3"
            },
            {
              "label": "22-35 days",
              "value": "bmc_question_2_option_4"
            },
            {
              "label": "35+ days",
              "value": "bmc_question_2_option_5"
            },
            {
              "label": "No shipping required",
              "value": "bmc_question_2_option_6"
            }
          ],
          "bmc_input_type": "single_select",
          "answer": [
            "bmc_question_2_option_1"
          ]
        }
      }
    },
    "authorized_person": {
      "name": "GAURAV KUMAR",
      "identity_numbers": {
        "individual_pan": {
          "type": "individual_pan",
          "value": "ABCPD1234A",
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792433137,
            "metadata": {},
            "created_at": 1792433137
          },
          "metadata": {},
          "is_skipped": false,
          "created_at": 1792433136,
          "updated_at": 1792433137
        }
      },
      "documents": {
        "aadhaar_front": {
          "id": "file_Kq8Vn2Lp5Xz7Wd",
          "type": "aadhaar_front",
          "url": "https://files.razorpay.com/documents/file_Kq8Vn2Lp5Xz7Wd",
          "metadata": {
            "source": "url",
            "file_name": "aadhaar-front.jpg",
            "mime_type": "image/jpeg",
            "size_bytes": 412688
          },
          "verification": {
            "status": "in_progress",
            "error_code": null,
            "error_description": null,
            "verified_at": null,
            "metadata": {},
            "created_at": 1792433137
          },
          "created_at": 1792433137
        },
        "aadhaar_back": {
          "id": "file_Mz3Rt6Qw1Yc8Ha",
          "type": "aadhaar_back",
          "url": "https://files.razorpay.com/documents/file_Mz3Rt6Qw1Yc8Ha",
          "metadata": {
            "source": "url",
            "file_name": "aadhaar-back.jpg",
            "mime_type": "image/jpeg",
            "size_bytes": 398214
          },
          "verification": {
            "status": "in_progress",
            "error_code": null,
            "error_description": null,
            "verified_at": null,
            "metadata": {},
            "created_at": 1792433137
          },
          "created_at": 1792433137
        }
      },
      "address": null,
      "date_of_birth": null,
      "additional_data": {},
      "created_at": 1792433136,
      "updated_at": 1792433137
    },
    "stakeholders": {},
    "addresses": [
      {
        "type": "registered_address",
        "line1": "12 MG Road",
        "line2": "Indiranagar",
        "city": "Bengaluru",
        "state": "KA",
        "postal_code": "560038",
        "country": "IN"
      },
      {
        "type": "operational_address",
        "line1": "Shop 4, 80 Feet Road",
        "line2": "Koramangala",
        "city": "Bengaluru",
        "state": "KA",
        "postal_code": "560034",
        "country": "IN"
      }
    ],
    "metadata": {}
  },
  "bank_accounts": {
    "settlements_primary": {
      "type": "settlements_primary",
      "account_number": "001234567890",
      "routing_code": "ICIC0000009",
      "routing_code_type": "IFSC",
      "supporting_document": null,
      "verification": {
        "status": "verified",
        "error_code": null,
        "error_description": null,
        "verified_at": 1792433138,
        "metadata": {},
        "created_at": 1792433138
      }
    }
  },
  "products": {
    "payment_gateway": {
      "type": "payment_gateway",
      "status": "in_progress",
      "status_reason": null,
      "created_at": 1792433135,
      "updated_at": 1792433138,
      "requirements": [
        {
          "id": "req_hocykxcAkjCdtB",
          "requirement_code": "ckyc_fetch",
          "requirement_level": "mandatory",
          "requirement_type": "composite",
          "description": "The person's CKYC record, fetched with a code or skipped.",
          "fulfillment_criteria": "one_of",
          "sub_requirements": [
            {
              "id": "req_2KRiIGIhuAPNW6",
              "requirement_code": "skip_ckyc",
              "requirement_level": "conditional",
              "requirement_type": "input",
              "description": "Skip CKYC.",
              "field_path": "business_profile.authorized_person.identity_numbers.individual_ckyc.is_skipped",
              "value_type": "boolean",
              "status": "created"
            },
            {
              "id": "req_L3rskP8gX6YVHh",
              "requirement_code": "send_ckyc_otp",
              "requirement_level": "conditional",
              "requirement_type": "action",
              "description": "A Central KYC record was found for your PAN. Get a code on the mobile on your CKYC record to fetch it.",
              "status": "created"
            }
          ],
          "status": "created"
        },
        {
          "id": "req_0HAQYzBrDRNnEM",
          "requirement_code": "accept_terms_of_service",
          "requirement_level": "mandatory",
          "requirement_type": "composite",
          "description": "Show the sub-merchant Razorpay's terms of service and record their acceptance.",
          "fulfillment_criteria": "all_of",
          "sub_requirements": [
            {
              "id": "req_CTW6xxsQmygIDU",
              "requirement_code": "acceptance_ip",
              "requirement_level": "mandatory",
              "requirement_type": "input",
              "description": "The IP address the terms were accepted from.",
              "field_path": "products.payment_gateway.terms_of_service_acceptance.ip",
              "value_type": "text",
              "status": "created"
            },
            {
              "id": "req_gXg6igx2STKrZA",
              "requirement_code": "acceptance_device_fingerprint_id",
              "requirement_level": "mandatory",
              "requirement_type": "input",
              "description": "The device fingerprint of the device the terms were accepted on.",
              "field_path": "products.payment_gateway.terms_of_service_acceptance.device_fingerprint_id",
              "value_type": "text",
              "status": "created"
            }
          ],
          "status": "created"
        }
      ],
      "terms_of_service_acceptance": null,
      "payment_channels": {
        "website": {
          "primary": "https://www.example.com",
          "additional": [],
          "verification": {
            "status": "in_progress",
            "error_code": null,
            "error_description": null,
            "verified_at": null,
            "metadata": {},
            "created_at": 1792433138
          }
        },
        "app_android": null,
        "app_ios": null
      },
      "clarification_responses": {}
    }
  },
  "notes": {
    "shop_id": "60291847"
  },
  "created_at": 1792433135,
  "updated_at": 1792433138
}
```

The response is the account with every element's verification. Here, `requirements` holds only what Create could not carry: `ckyc_fetch` and `accept_terms_of_service`.

The business-model answer in this example covers the only question for the `fashion_and_lifestyle` subcategory, `bmc_question_2`. If you already know the questions for a subcategory, answer them in Create. Know more about [business model questions](https://razorpay.com/docs/api/partners/accounts/business-model-questions.md). Any question left unanswered comes back as an input of the `business_model_clarifications` composite requirement. The updates that follow look the same as in a step-by-step integration.

> [accordion] Request Parameters
>
> The top-level fields below are optional in this call. Each is due before submission when the product's `requirements` list it. A nested field marked mandatory applies only when you send its parent object. The `country` and `user` fields are as in [1.2 Create an Account](#1-2-create-an-account).
>
> `statement_descriptor` *optional*
> : `object` The name customers see on their bank statements and receipts.
>
> `statement_descriptor.value` *mandatory*
> : `string` The brand name shown on customer statements. Up to 255 characters. For example, `Acme Corp`.
>
> `business_profile` *optional*
> : `object` The business's KYC details.
>
> `business_profile.business_type` *mandatory*
> : `string` The type of business. For example, `individual` or `private_limited`.
>
> `business_profile.authorized_person` *optional*
> : `object` The authorised person.
>
> `business_profile.authorized_person.identity_numbers` *mandatory*
> : `object` The authorised person's identity numbers, keyed by type. For example, their PAN at `individual_pan`.
>
> `business_profile.authorized_person.documents` *mandatory*
> : `object` The authorised person's documents, keyed by type. For example, `aadhaar_front` sent as a `url`.
>
> `business_profile.stakeholders` *optional*
> : `object` The people who own a share of the business, keyed by stakeholder ID. Each stakeholder takes the same fields as the authorised person, with `percentage_ownership`.
>
> `business_profile.stakeholders.<stakeholder_id>.percentage_ownership` *mandatory*
> : `number` The stakeholder's share of the business, as a decimal from 0 to 100. For example, `25.5`.
>
> `business_profile.addresses` *optional*
> : `array` The `registered_address` and the `operational_address`, each an object with its `type`. Each takes `type`, `line1`, `line2`, `city`, `state`, `postal_code` and `country`. All but `line2` are mandatory in each address you send.
>
> `business_profile.business_category` *optional*
> : `object` How the business is classified, with the `mcc`, the `business_description` and the `business_model_clarifications` keyed by question ID.
>
> `business_profile.business_category.category` *mandatory*
> : `string` The business category. For example, `ecommerce`.
>
> `business_profile.business_category.subcategory` *mandatory*
> : `string` The subcategory of the category. For example, `fashion_and_lifestyle`. Know more about [business categories and subcategories](https://razorpay.com/docs/api/partners/accounts/business-categories.md).
>
> `bank_accounts` *optional*
> : `object` The settlement bank account at `settlements_primary`.
>
> `bank_accounts.settlements_primary.account_number` *mandatory*
> : `string` The settlement account number, 5 to 35 digits. For example, `001234567890`.
>
> `bank_accounts.settlements_primary.routing_code` *mandatory*
> : `string` The bank's Indian Financial System Code (IFSC). For example, `ICIC0000009`.
>
> `bank_accounts.settlements_primary.routing_code_type` *mandatory*
> : `string` The kind of routing code. Possible value: `IFSC`.
>
> `products.payment_gateway.payment_channels` *mandatory*
> : `object` Where the business takes payments: `website`, `app_android` or `app_ios`.

Refer to [Create an Account](https://razorpay.com/docs/api/partners/accounts/create.md) for every request parameter and error.

## Next Step

[Collect Requirements](https://razorpay.com/docs/partners/aggregators/onboarding-api/collect-requirements.md)
