Get account

GET

/v1/accounts/{accountId}

curl --request GET \
  --url https://api-v1.tailwind.ai/v1/accounts/example \
  --header 'Authorization: Bearer <token>'

• Production
• Development

Get a single connected Pinterest account. A 404 means the account is unknown, is not yours (the two are deliberately indistinguishable, so that account IDs cannot be enumerated), or is one of your own accounts that is no longer connected to Tailwind — the last case says so in the message.

Authorizations

• bearerAuth

Parameters

Path Parameters

accountId

required

string

Numeric Tailwind account ID returned by GET /v1/accounts

Responses

200

Account details

Media typeapplication/json

object

data

object

account

A single account. Same fields as an entry in GET /v1/accounts, plus the verified domain.

object

id

Account ID

string

userId

Pinterest user ID

string

displayName

Display name

string

nullable

username

Pinterest username

string

nullable

avatarUrl

Profile image URL

string

nullable

tokenAuthorized

Whether the Pinterest token is valid

boolean

isDomainVerified

Whether the domain is verified

boolean

domainUrl

The account’s claimed domain. Omitted when no domain is set.

string

createdAt

When the account was connected (Unix timestamp)

integer

nullable

meta

object

requestId

Unique request ID for debugging

string

Example^generated

{
  "data": {
    "account": {
      "id": "example",
      "userId": "example",
      "displayName": "example",
      "username": "example",
      "avatarUrl": "example",
      "tokenAuthorized": true,
      "isDomainVerified": true,
      "domainUrl": "example",
      "createdAt": 1
    }
  },
  "meta": {
    "requestId": "example"
  }
}

401

Authentication required or invalid bearer credentials

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "requestId": "abc123"
  }
}

404

Resource not found

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Account not found"
  },
  "meta": {
    "requestId": "abc123"
  }
}

429

Rate limit exceeded

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable denial reason. Present on PAYMENT_REQUIRED errors: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily rate limit of 5000 requests exceeded. Resets at midnight UTC."
  },
  "meta": {
    "requestId": "abc123"
  }
}