---
title: "Create card application"
description: "Initiate a new card application request for a customer."
protocol: rest
method: POST
endpoint: "/v1/cards/applications/new"
baseUrl: "https://api.gravv.xyz"
group: "Cards"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Create card application

<Endpoint method="POST" path="/v1/cards/applications/new" />

Initiate a new card application request for a customer.

## 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>

## Request Body

<ParamField name="customer_id" body="customer_id" type="string" required>
  ID of the customer creating the card application
</ParamField>

<ParamField name="account_id" body="account_id" type="string" required>
  ID of the account to link the card application to
</ParamField>

<ParamField name="annual_remuneration" body="annual_remuneration" type="number" required>
  Customer's annual income or renumeration
</ParamField>

<ParamField name="estimated_monthly_limit" body="estimated_monthly_limit" type="number" required>
  Estimated monthly limit the customer expects to use
</ParamField>

<ParamField name="ip_address" body="ip_address" type="string" required>
  IP address of the request origin
</ParamField>

### Request Examples

<RequestExample>

```json title="Request"
{
  "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
  "account_id": "2d52eb6d-4fac-44db-a225-d0e6aa13b0e3",
  "annual_remuneration": 120000,
  "estimated_monthly_limit": 200,
  "ip_address": "12.23.31.23"
}
```

</RequestExample>

## Responses

| Status | Description |
| --- | --- |
| `200` | Card application request successful |

### 200 response

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

  <Expandable title="properties">
    <ResponseField name="message" type="string">
      Status message returned after application request
    </ResponseField>

    <ResponseField name="id" type="string">
      ID of the card application
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the card (card lifecycle status)

      Possible values: `active`, `freeze`, `blocked`, `inactive`
    </ResponseField>

  </Expandable>
</ResponseField>

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

<ResponseExample>

```json title="Response"
{
  "data": {
    "message": "Card application request successful",
    "id": "a14ec356-f33d-4384-ba68-4d9bfa19765b",
    "status": "active"
  },
  "error": null
}
```

</ResponseExample>

## Authorization

- **ApiKeyAuth**