API keys

The dashboard endpoints under /api/v1/api-keys let you manage your API keys programmatically. These endpoints are intended for the web dashboard and CLI tools — they’re authenticated with a Clerk JWT, not an API key.

Authentication: These endpoints require a Clerk session token (Bearer eyJ...), not a paid_* API key.

Create an API key

POST /api/v1/api-keys

Generates a new API key. The key field is shown only once and never returned again — store it immediately.

Request

curl -X POST https://api.propaideals.co.uk/api/v1/api-keys \
  -H "Authorization: Bearer $CLERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production server" }'

const res = await fetch('https://api.propaideals.co.uk/api/v1/api-keys', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${clerkToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Production server' }),
})
const created = await res.json()
console.log('Save this:', created.key)

res = requests.post(
    "https://api.propaideals.co.uk/api/v1/api-keys",
    json={"name": "Production server"},
    headers={"Authorization": f"Bearer {clerk_token}"},
)
created = res.json()
print("Save this:", created["key"])

Body parameters

Field	Type	Required	Description
`name`	string	yes	Human-readable name (1–100 chars)
`expires_at`	ISO datetime	no	Optional expiry timestamp (UTC)

Response — `201 Created`

{
  "id": "5fa1b2c3-d4e5-6f78-9012-3456789abcde",
  "name": "Production server",
  "prefix": "paid_a1b2c3",
  "key": "paid_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "scopes": [
    "properties:read",
    "market-data:read",
    "rentals:read",
    "investment:read",
    "areas:read",
    "spatial:read"
  ],
  "plan": "developer",
  "status": "active",
  "last_used": null,
  "expires_at": null,
  "created_at": "2026-04-14T10:30:00Z"
}

The key field is only returned in this response. All other endpoints (and listings) only return the prefix. If you lose the key, you must revoke and re-create it.

Limits

Maximum 5 active keys per user. Creating a 6th returns 400 Bad Request with the message “Maximum of 5 active API keys per user reached”.

List your API keys

GET /api/v1/api-keys

Returns all of your API keys (active and revoked).

Request

curl https://api.propaideals.co.uk/api/v1/api-keys \
  -H "Authorization: Bearer $CLERK_TOKEN"

Response

[
  {
    "id": "5fa1b2c3-d4e5-6f78-9012-3456789abcde",
    "name": "Production server",
    "prefix": "paid_a1b2c3",
    "scopes": ["properties:read", "market-data:read"],
    "plan": "developer",
    "status": "active",
    "last_used": "2026-04-14T10:25:00Z",
    "expires_at": null,
    "created_at": "2026-04-14T10:30:00Z"
  },
  {
    "id": "9c8d7e6f-...",
    "name": "Staging server",
    "prefix": "paid_x9y8z7",
    "scopes": ["properties:read"],
    "plan": "developer",
    "status": "revoked",
    "last_used": "2026-04-10T08:00:00Z",
    "expires_at": null,
    "created_at": "2026-03-01T09:00:00Z"
  }
]

Revoke an API key

DELETE /api/v1/api-keys/{key_id}

Immediately revokes a key. The Redis cache is purged within 5 minutes of revocation, after which all requests using the key fail with 401 invalid_api_key.

Request

curl -X DELETE https://api.propaideals.co.uk/api/v1/api-keys/5fa1b2c3-d4e5-6f78-9012-3456789abcde \
  -H "Authorization: Bearer $CLERK_TOKEN"

Response — `200 OK`

{
  "status": "revoked",
  "key_id": "5fa1b2c3-d4e5-6f78-9012-3456789abcde"
}

Returns 404 if the key doesn’t exist or doesn’t belong to the authenticated user.

Get current usage

GET /api/v1/api-billing/usage

Returns the current billing period’s usage across all your active keys.

Request

curl https://api.propaideals.co.uk/api/v1/api-billing/usage \
  -H "Authorization: Bearer $CLERK_TOKEN"

Response

{
  "requests_used": 4321,
  "requests_limit": 100000,
  "ai_chat_used": 87,
  "ai_chat_limit": 1000,
  "plan_tier": "professional",
  "plan_name": "Professional",
  "billing_period_start": "2026-04-01T00:00:00+00:00",
  "billing_period_end": "2026-05-01T00:00:00+00:00"
}

null for requests_limit or ai_chat_limit means unlimited (Enterprise plans).

List available plans

GET /api/v1/api-billing/plans

Public endpoint (no auth required) — returns the list of API plans for your pricing page.

Response

[
  {
    "id": "starter",
    "name": "Starter",
    "monthly_price_pence": 9900,
    "monthly_request_limit": 20000,
    "rate_limit_per_second": 10,
    "ai_chat_limit": 100,
    "batch_limit": 100,
    "scopes": [
      "properties:read",
      "market-data:read",
      "investment:read",
      "areas:read",
      "spatial:read",
      "planning:read",
      "leads:read",
      "epc:read"
    ]
  },
  {
    "id": "professional",
    "name": "Professional",
    "monthly_price_pence": 29900,
    "monthly_request_limit": 100000,
    "rate_limit_per_second": 25,
    "ai_chat_limit": 1000,
    "batch_limit": 200,
    "scopes": [
      "properties:read",
      "market-data:read",
      "investment:read",
      "areas:read",
      "spatial:read",
      "planning:read",
      "leads:read",
      "epc:read",
      "ai:chat",
      "build-cost:read"
    ]
  },
  {
    "id": "business",
    "name": "Business",
    "monthly_price_pence": 99900,
    "monthly_request_limit": 400000,
    "rate_limit_per_second": 50,
    "ai_chat_limit": 4000,
    "batch_limit": 500,
    "scopes": [
      "properties:read",
      "market-data:read",
      "investment:read",
      "areas:read",
      "spatial:read",
      "planning:read",
      "leads:read",
      "epc:read",
      "ai:chat",
      "build-cost:read"
    ]
  }
]

All tiers are paid — there is no free or Developer tier. The three plans are £99, £299, and £999 per month respectively. Enterprise plans are provisioned manually (contact info@propaideals.co.uk).

Get started

API reference

Granular endpoints

Resources

API keys (dashboard endpoints)

API keys

Create an API key

Request

Body parameters

Response — `201 Created`

Limits

List your API keys

Request

Response

Revoke an API key

Request

Response — `200 OK`

Get current usage

Request

Response

List available plans

Response

​API keys

​Create an API key

​Request

​Body parameters

​Response — 201 Created

​Limits

​List your API keys

​Request

​Response

​Revoke an API key

​Request

​Response — 200 OK

​Get current usage

​Request

​Response

​List available plans

​Response

API keys

Create an API key

Request

Body parameters

Response — `201 Created`

Limits

List your API keys

Request

Response

Revoke an API key

Request

Response — `200 OK`

Get current usage

Request

Response

List available plans

Response