---
title: "Process account application"
description: "Process the submitted application with the relevant provider."
protocol: rest
method: POST
endpoint: "/v1/accounts/applications/{id}/process"
baseUrl: "https://api.gravv.xyz"
group: "Accounts"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Process account application

<Endpoint method="POST" path="/v1/accounts/applications/{id}/process" />

Process the submitted application with the relevant provider.

## Headers

<ParamField name="Idempotency-Key" header="Idempotency-Key" type="string" required>
  Required for POST requests. Reuse the key only when retrying the same operation with an identical payload.
</ParamField>

## Path Parameters

<ParamField name="id" path="id" type="string" required>
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | Application processed |
| `400` | Request failed. All gateway errors are returned as HTTP 400 with this envelope. |

### 200 response

<ResponseField name="data" type="object" required>

  <Expandable title="properties">
    <ResponseField name="application_id" type="string">
    </ResponseField>

    <ResponseField name="status" type="string">
    </ResponseField>

    <ResponseField name="account" type="oneOf">

      One of the following variants:

      <Expandable title="Variant 1">
        <ResponseField name="id" type="string">
        </ResponseField>

        <ResponseField name="label" type="string">
        </ResponseField>

        <ResponseField name="date_created" type="string">
        </ResponseField>

        <ResponseField name="wallet_address" type="string">
        </ResponseField>

        <ResponseField name="blockchain_network" type="string">
        </ResponseField>

        <ResponseField name="type" type="string">
          Account kind.
        </ResponseField>

        <ResponseField name="customer_id" type="string">
        </ResponseField>

        <ResponseField name="capabilities" type="string[]">
        </ResponseField>

        <ResponseField name="currency" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_id" type="string">
        </ResponseField>

        <ResponseField name="tenant_name" type="string">
        </ResponseField>

        <ResponseField name="tenant_id" type="string">
        </ResponseField>

        <ResponseField name="tier" type="string">
        </ResponseField>

        <ResponseField name="status" type="string">

          Possible values: `active`, `frozen`, `deleted`, `pending`
        </ResponseField>

        <ResponseField name="category" type="string">
        </ResponseField>

        <ResponseField name="balance" type="string">
        </ResponseField>

        <ResponseField name="is_tokenized" type="boolean">
        </ResponseField>

        <ResponseField name="inflow_behavior" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_name" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_address" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_beneficiary_address" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_beneficiary_name" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_account_number" type="string">
        </ResponseField>

        <ResponseField name="virtual_account_bank_routing_number" type="string">
        </ResponseField>

        <ResponseField name="assets" type="object[]">

          <Expandable title="properties">
            <ResponseField name="balance" type="string">
            </ResponseField>

            <ResponseField name="decimals" type="integer">
            </ResponseField>

            <ResponseField name="symbol" type="string">
            </ResponseField>

          </Expandable>
        </ResponseField>

        <ResponseField name="metadata" type="object">
        </ResponseField>

      </Expandable>

      - **null** (`null`)
    </ResponseField>

    <ResponseField name="errors" type="object[]">

      <Expandable title="properties">
        <ResponseField name="stage" type="string">
          Processing stage where the error occurred.
        </ResponseField>

        <ResponseField name="message" type="string">
          Human-readable explanation of the processing error.
        </ResponseField>

        <ResponseField name="code" type="string">
          Machine-readable error code.
        </ResponseField>

        <ResponseField name="suggestion" type="string">
          Suggested fix.
        </ResponseField>

      </Expandable>
    </ResponseField>

    <ResponseField name="metadata" type="object">
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseField name="error" type="null" required>
</ResponseField>

### 400 response

<ResponseField name="data" type="null" required>
</ResponseField>

<ResponseField name="error" type="string" required>
  Human-readable error message.
</ResponseField>

## Authorization

- **ApiKeyAuth**