API reference

Account

Who a call acts for, and the organizations a key can act for.

On this page

Who the key is
Headers
Example request
Response 200
Organizations the key can act for
Headers
Example request
Response 200

Base address https://api.stillmoregroup.com/api/v1. Every answer is JSON; errors have one shape.

Endpoint	What it does
`GET /me`	Who the key is
`GET /organizations`	Organizations the key can act for

Who the key is#

GET /me · any key

The organization, the key's scopes and limits, and the release lead time. A cheap call to check a key works.

Headers#

Stillmore-Organization: A sub-label to act for, when the key may (see Sub-labels).

Example request#

curl "https://api.stillmoregroup.com/api/v1/me" \
  -H "Authorization: Bearer $STILLMORE_API_KEY"

Response 200#

data holds the object below.

organizationobject
organization.idstring
organization.namestring
organization.kindstring: One of LABEL, ARTIST, MANAGEMENT.
keyobject
key.idstring
key.namestring
key.modestring: One of live, test.

Show 19 more fields

key.scopesstring[]: Granted scopes, including the read scopes write scopes bring. Each one of releases:read, releases:write, releases:submit, artists:read, artists:write, labels:read, labels:write, finance:read, payouts:write, webhooks:manage.
key.createdAtstring: ISO 8601 timestamp in UTC.
key.expiresAtstring or null: ISO 8601 timestamp in UTC.
key.lastUsedAtstring or null: ISO 8601 timestamp in UTC.
keyOrganizationobject: The organization the key belongs to; another than organization when the request acts for a sub-label.
keyOrganization.idstring
keyOrganization.namestring
actingAsobject: The member the key acts for.
actingAs.idstring
actingAs.namestring
rateLimitobject
rateLimit.perMinuteinteger: Requests per minute for this key. From -9007199254740991 to 9007199254740991.
rateLimit.organizationPerMinuteinteger: Requests per minute shared by every key of the organization. From -9007199254740991 to 9007199254740991.
autoApprovalboolean: Submissions of this organization are approved without a person once their checks are clean.
submissionsobject
submissions.perDayinteger: Releases the API may submit per UTC day. From -9007199254740991 to 9007199254740991.
releasePolicyobject
releasePolicy.leadDaysinteger: Days a release date must keep from submission. From -9007199254740991 to 9007199254740991.
releasePolicy.earliestReleaseDatestring (date): The earliest release date a submission made today can carry.

Example response

{
  "data": {
    "organization": {
      "id": "6731c2a1b3c4d5e6f7a8b9c0",
      "name": "June Hale",
      "kind": "LABEL"
    },
    "key": {
      "id": "6731c2a1b3c4d5e6f7a8b9c0",
      "name": "June Hale",
      "mode": "live",
      "scopes": [
        "releases:read"
      ],
      "createdAt": "2026-11-01T09:30:00.000Z",
      "expiresAt": "2026-11-01T09:30:00.000Z",
      "lastUsedAt": "2026-11-01T09:30:00.000Z"
    },
    "keyOrganization": {
      "id": "6731c2a1b3c4d5e6f7a8b9c0",
      "name": "June Hale"
    },
    "actingAs": {
      "id": "6731c2a1b3c4d5e6f7a8b9c0",
      "name": "June Hale"
    },
    "rateLimit": {
      "perMinute": 1,
      "organizationPerMinute": 1
    },
    "autoApproval": false,
    "submissions": {
      "perDay": 1
    },
    "releasePolicy": {
      "leadDays": 1,
      "earliestReleaseDate": "2027-01-15"
    }
  }
}

Organizations the key can act for#

GET /organizations · any key

The key's own organization, and the sub-labels below it when the key may act for them. To act for a sub-label, send its id in the Stillmore-Organization header: every id, list and limit is then that sub-label's, as if it had its own key.

Headers#

Stillmore-Organization: A sub-label to act for, when the key may (see Sub-labels).

Example request#

curl "https://api.stillmoregroup.com/api/v1/organizations" \
  -H "Authorization: Bearer $STILLMORE_API_KEY"

Response 200#

A page: data holds the items below, hasMore says whether another page follows, and nextCursor is the cursor for it.

idstring
namestring
kindstring: One of LABEL, ARTIST, MANAGEMENT.
statusstring: One of ACTIVE, SUSPENDED.
parentIdstring or null
depthinteger: 0 for the key's own organization, 1 for its sub-labels, and so on. From -9007199254740991 to 9007199254740991.
currentboolean: The organization this request acted for.

Example response

{
  "data": [
    {
      "id": "6731c2a1b3c4d5e6f7a8b9c0",
      "name": "June Hale",
      "kind": "LABEL",
      "status": "ACTIVE",
      "parentId": "6731c2a1b3c4d5e6f7a8b9c0",
      "depth": 1,
      "current": false
    }
  ],
  "hasMore": false,
  "nextCursor": null
}