# Your endpoint

Each form you create gets a unique, permanent API endpoint. All submissions to that
URL are stored in your database.

## Endpoint format

```text
https://app.paceforms.com/api/f/{YOUR_FORM_ID}
```

Example:

```text
https://app.paceforms.com/api/f/NR-6Ww88ET
```

## What it accepts

| Property | Value |
| --- | --- |
| Method | `POST` |
| Content types accepted | `application/x-www-form-urlencoded`, `multipart/form-data`, `application/json` |
| CORS | Allowed from any origin |
| Default redirect | PaceForms thank-you page (customizable — see [Custom redirect](https://paceforms.com/docs/form-api/custom-redirect)) |

## Response format

All API responses return JSON. Use the status code and body to handle success and
error states in your UI.

**Success — 200 OK**

```json
{
  "status": "ok",
  "id": "sub_NR6Ww88ET_1746612345",
  "message": "Submission received"
}
```

**Validation error — 422 Unprocessable Entity**

```json
{
  "status": "error",
  "error": "validation_failed",
  "fields": {
    "email": "Must be a valid email address"
  }
}
```

**Spam blocked — 400 Bad Request**

```json
{
  "status": "error",
  "error": "spam_detected"
}
```

**Rate limit exceeded — 429 Too Many Requests**

```json
{
  "status": "error",
  "error": "rate_limit_exceeded",
  "message": "Monthly submission limit reached. Upgrade your plan."
}
```
