RecomlyRecomlyRecomlyDocs
Recomly APIEndpointsAccount

Get account

Retrieve the organization account for the authenticated user.

GET /api/app/account

Returns the organization record associated with the caller's account. All authenticated users can call this endpoint.


Request

See API Basics for required headers.

This endpoint takes no request body or query parameters.


Sample request

curl https://api.recomly.com/api/app/account \
  -H "Authorization: Bearer rk_live_abc123:def456"

Sample response

Status: 200 OK

{
  "org": {
    "orgId": "a1b2c3d4-0000-4000-8000-e5f6a7b8c9d0",
    "name": "Acme Plumbing Co.",
    "status": "active",
    "tier": "pro",
    "createdAt": "2026-01-15T09:00:00.000Z",
    "enabledFeatures": {
      "users": 5,
      "campaigns": 10,
      "advocates": 1000,
      "referrals": 1000,
      "sso": true,
      "api": true,
      "auditRetentionDays": 365
    },
    "trialEndsAt": "2026-02-15T09:00:00.000Z",
    "tosAcceptedAt": "2026-01-16T10:30:00.000Z",
    "tosVersion": "2026-01-01"
  }
}

trialEndsAt, tosAcceptedAt, and tosVersion are omitted when not set.


Error responses

See API Basics for standard status codes and error response format.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.