Skip to main content
GET
/
v1
/
team
Get your team info
curl --request GET \
  --url https://api.aurous-labs.com/v1/team \
  --header 'X-Api-Key: <api-key>'
{
  "id": "team_01HXMQ7Z3K8Y2ABCDEFGHJKM",
  "name": "Acme Studio",
  "credits": 500,
  "created_at": "2026-01-15T00:00:00Z",
  "billing_mode": "metered",
  "billing_email": "billing@acme.com"
}

Authorizations

​
X-Api-Key
string
header
required

Your team API key (starts with al_live_).

Headers

​
Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-05-15"

Response

Team information

​
id
string
required

Opaque team ID — never exposed as a sequential int. Stable across team renames.

Example:

"team_01HXMQ7Z3K8Y2ABCDEFGHJKM"

​
name
string
required

Team display name

Example:

"Acme Studio"

​
credits
number
required

Current credit balance

Example:

500

​
created_at
string
required

Creation timestamp (ISO 8601)

Example:

"2026-01-15T00:00:00Z"

​
billing_mode
string
required

Billing mode. Known values: "metered" (default) — generations are charged and gated on the credit balance; "exempt" — the team is never charged and never blocked. OPEN enum, typed as a plain string: new modes may be added, so treat any unrecognized value as non-gating (do not hard-code a closed set).

Example:

"metered"

​
billing_email
string

Billing email address

Example:

"billing@acme.com"