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

# Create APR policy

> Create a new annual percentage rate (APR) policy.

POST/credit/policies/aprs

Create a new annual percentage rate (APR) policy.

## Request body

| Fields | Description |
| - | - |
| token string  Optional | Unique identifier of the APR policy. **Allowable Values:**  36 char max |
| name string  Required | Name of the APR policy. **Allowable Values:**  255 char max |
| description string  Optional | Description of the APR policy. **Allowable Values:**  255 char max |
| purchases object  Required | Contains information on the pricing strategy for purchases. **Allowable Values:**  Existing `purchases` object |
| purchases.**name** string  Optional | Name of the pricing strategy. **Allowable Values:**  255 char max |
| purchases.**external\_token** string  Optional | Unique identifier of the external pricing strategy for the credit program. **Allowable Values:**  Valid external pricing strategy token |
| purchases.**tiers** array of objects  Required | One or more risk tiers for a pricing strategy. **Allowable Values:**  One or more `tiers` objects |
| purchases.tiers\[].**margin\_rate** decimal  Required | Number of percentage points added to the prime rate, used to calculate a variable APR value. **Allowable Values:**  Format: 0.00 |

## Sample request body

```json JSON lines wrap theme={null}
{
  "token": "my_apr_policy_token_1234",
  "name": "Gold APR Policy",
  "description": "A gold APR policy",
  "purchases": {
    "name": "A purchase at a merchant",
    "external_token": "my_external_purchase_token1234",
    "tiers": [
      {
        "margin_rate": 1,
        "apr": 0
      },
      {
        "margin_rate": 5,
        "apr": 0
      }
    ]
  }
}
```

## Response body

| Fields | Description |
| - | - |
| token string  Conditionally returned | Unique identifier of the APR policy. **Allowable Values:**  36 char max |
| name string  Conditionally returned | Name of the APR policy. **Allowable Values:**  255 char max |
| description string  Conditionally returned | Description of the APR policy. **Allowable Values:**  255 char max |
| purchases object  Conditionally returned | Contains information on the pricing strategy for purchases. **Allowable Values:**  Existing `purchases` object |
| purchases.**name** string  Conditionally returned | Name of the pricing strategy. **Allowable Values:**  255 char max |
| purchases.**external\_token** string  Conditionally returned | Unique identifier of the pricing strategy on a credit program. **Allowable Values:**  36 char max |
| purchases.**tiers** array of objects  Conditionally returned | One or more risk tiers for a pricing strategy. **Allowable Values:**  One or more `tiers` objects |
| purchases.tiers\[].**margin\_rate** decimal  Conditionally returned | Margin rate for the risk tier for a pricing strategy. **Allowable Values:**  Format: 0.00 |
| purchases.tiers\[].**apr** decimal  Conditionally returned | Value of the APR. **Allowable Values:**  Format: 0.00 |
| effective\_date date  Conditionally returned | Date the APR goes into effect, in UTC. **Allowable Values:**  Format: yyyy-MM-dd |
| created\_time datetime  Conditionally returned | Date and time when the APR policy was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| updated\_time datetime  Conditionally returned | Date and time when the APR policy was last updated on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "token": "my_apr_policy_token_1234",
  "name": "Gold APR Policy",
  "description": "A gold APR policy",
  "purchases": {
    "name": "A purchase at a merchant",
    "external_token": "my_external_purchase_token1234",
    "tiers": [
      {
        "margin_rate": 1,
        "apr": 0
      },
      {
        "margin_rate": 5,
        "apr": 0
      }
    ]
  },
  "effective_date": "2025-05-01",
  "created_time": "2025-04-01T23:41:58.802Z",
  "updated_time": "2025-04-05T16:04:48.643Z"
}
```


## Related topics

- [APR Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies/apr-policies.md)
- [Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies.md)
- [Clone APR policy](https://www.marqeta.com/docs/core-api/credit-policies/apr-policies/clone-apr.md)
- [Retrieve APR policy](https://www.marqeta.com/docs/core-api/credit-policies/apr-policies/retrieve-apr.md)
- [Update APR policy](https://www.marqeta.com/docs/core-api/credit-policies/apr-policies/update-apr.md)