Read the collection and environment this key belongs to

GET /v1/developer/credential

Operation ID: getDeveloperCredential

Returns the presenting key’s collection (id, slug, name), its TEST/LIVE environment, and the capabilities it grants. Use the slug in /v1/developer/collections/{collection} routes.

Contract status

Field	Value
Maturity	`beta`
Required capability	`collections.read`
Freshness class	`authenticated-state`
Quota cost	`1`

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential’s installation grants; identifiers in the URL never grant access.

Request parameters

This operation has no query, path, or explicit header parameters.

Request body

This operation has no JSON request body.

cURL

Set KISMET_API_ORIGIN=https://api.ksmt.app and configure KISMET_DEVELOPER_API_KEY in your environment. Run server-credential requests from your backend, not browser code.

curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/credential" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"

Responses

Status	Meaning
200	Success.
400	Invalid request parameters or body.
401	Missing, invalid, expired, or inappropriate credential/session.
403	Credential lacks the required grant/capability, or an origin/CSRF check failed.
429	Rate limit or quota exceeded; inspect response metadata before retrying.
503	A required Kismet dependency is temporarily unavailable.

200 response example

{
  "resourceType": "credential",
  "collection": {
    "id": "22222222-2222-4222-8222-222222222222",
    "slug": "coastal-reference-rentals",
    "name": "Coastal Reference Rentals"
  },
  "environment": "TEST",
  "capabilities": [
    "collections.read",
    "vacation_rentals.read"
  ]
}

200 response schema

Content type: application/json. Required fields, nullable values, and nested structures are defined below.

View complete response schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "resourceType",
    "collection",
    "environment",
    "capabilities"
  ],
  "properties": {
    "resourceType": {
      "type": "string",
      "enum": [
        "credential"
      ]
    },
    "collection": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "slug",
        "name"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "environment": {
      "type": "string",
      "enum": [
        "TEST",
        "LIVE"
      ]
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}