Skip to main content
GET
/
projects
/
{projectId}
/
api-keys
/
{id}
Get an API key by ID
curl --request GET \
  --url https://api.engagefabric.com/projects/{projectId}/api-keys/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "projectId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Production Mobile App Key",
  "prefix": "pp_live_",
  "scopes": [
    "events:write",
    "players:read",
    "players:write"
  ],
  "status": "ACTIVE",
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z",
  "rateLimit": 1000,
  "expiresAt": "2026-12-31T23:59:59Z",
  "lastUsedAt": "2025-01-15T10:30:00Z",
  "metadata": {
    "createdBy": "admin@example.com"
  },
  "deletedAt": null
}

Authorizations

​
Authorization
string
header
required

JWT token for admin console authentication

Path Parameters

​
projectId
string
required

Project UUID

​
id
string
required

API Key UUID

Response

API key found

​
id
string
required

Unique API key identifier

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
projectId
string
required

Project ID this key belongs to

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
name
string
required

API key name/description

Example:

"Production Mobile App Key"

​
prefix
string
required

API key prefix (for identification)

Example:

"pp_live_"

​
scopes
string[]
required

API key scopes/permissions

Example:
[
  "events:write",
  "players:read",
  "players:write"
]
​
status
enum<string>
required

API key status

Available options:
ACTIVE,
REVOKED,
EXPIRED
Example:

"ACTIVE"

​
createdAt
string<date-time>
required

Creation timestamp

Example:

"2025-01-15T10:30:00Z"

​
updatedAt
string<date-time>
required

Last update timestamp

Example:

"2025-01-15T10:30:00Z"

​
rateLimit
object

Custom rate limit (requests per minute)

Example:

1000

​
expiresAt
object

API key expiration date

Example:

"2026-12-31T23:59:59Z"

​
lastUsedAt
object

Last time this key was used

Example:

"2025-01-15T10:30:00Z"

​
metadata
object

Additional metadata

Example:
{ "createdBy": "admin@example.com" }
​
deletedAt
object

Soft deletion timestamp

Example:

null