Skip to content
DYCRYPT

The machines this licence has bound

GET
/api/licenses/{lid}/machines
curl --request GET \
  --url https://app.dycrypt.com/o/acme/api/licenses/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/machines \
  --header 'Authorization: Bearer <token>'

Oldest first, released ones included — “this licence has moved four times” is the signal that somebody is sharing it, and it only shows up over time.

parts is the fingerprint’s components, decoded; atIssue marks a machine inside the licence’s signature, which cannot be released.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
lid
required
string format: uuid

The licence id — a UUID, and the lid claim in the signed payload. It survives renewal.

Responses

Section titled “Responses”

200

Section titled “200”

One entry per binding, live or released.

Media typeapplication/json
Array<object>
object
id
required
integer format: int64
parts
required

The fingerprint’s components, decoded — the truncated hashes, never raw values.

object
key
additional properties
string
boundAt
required
string format: date-time
releasedAt
string | null format: date-time
releasedBy
string | null
live
required

Still holding a seat.

boolean
atIssue
required

Inside the signature

boolean
Examplegenerated
[
  {
    "id": 1,
    "parts": {
      "additionalProperty": "example"
    },
    "boundAt": "2026-04-15T12:00:00Z",
    "releasedAt": "2026-04-15T12:00:00Z",
    "releasedBy": "example",
    "live": true,
    "atIssue": true
  }
]

401

Section titled “401”

No credential, or one that no longer resolves — revoked, expired, deleted. Replace it.

Media typeapplication/json

Every failure in this API has this shape and no other.

object
error
required
string
Example
{
  "error": "this token does not have licenses:write"
}

403

Section titled “403”

Authenticated, but not allowed: a missing scope, a read-only role, a plan limit reached, or a credential used under another organisation’s slug. The right credential doing something it may not do.

Media typeapplication/json

Every failure in this API has this shape and no other.

object
error
required
string
Example
{
  "error": "this token does not have licenses:write"
}

404

Section titled “404”

No such record, or no such endpoint.

Media typeapplication/json

Every failure in this API has this shape and no other.

object
error
required
string
Example
{
  "error": "this token does not have licenses:write"
}