Accounts

Get an account by ID

GET/v2/accounts/{accountId}Try it

Returns an account's details. An API key only reads the account that holds it (use @me or its own id).

Request

Authorization

Bearer token

Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.

Path parameters
  • accountIdstringrequired
    Unique identifier of the account

Responses

200Successfully retrieved account details
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)

Type: Error

403The API key is inactive or revoked (INACTIVE_API_KEY), or targets another account (ACCOUNT_ACCESS_DENIED, refused once the account guard is enforced); with an OAuth access token: a token of scope mcp (INSUFFICIENT_SCOPE), a path naming another account or a person no longer a member of it (ACCOUNT_ACCESS_DENIED), a real token on the sandbox host (SANDBOX_REQUIRES_TEST_KEY)

Type: Error

404Account not found

Type: Error

429
500Server error

Type: Error

Request
curl -X GET "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
Response 200
{
  "success": true,
  "account": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "displayname": "John Doe",
    "email": "[email protected]",
    "phone": "+1234567890",
    "balance": 100.5,
    "minimal_balance": 0,
    "minimal_credit": 0,
    "fiscal_number": "FR12345678901",
    "subscription_plan": {
      "id": "987e6543-e21a-11d4-a789-0242ac120002",
      "displayname": "Basic Plan",
      "price": 49.99,
      "shippingLetter": true,
      "whiteLabel": false
    },
    "options": {
      "lang": "EN",
      "payments": {
        "groupWithSubscription": false
      }
    },
    "createdAt": "2024-01-01T10:00:00.000Z",
    "updatedAt": "2024-11-01T12:00:00.000Z",
    "subscription_plan_source": "stripe"
  }
}