Bloss Docs

Get one creator's profile

Developers
GET
/brands/{brandId}/creators/{creatorId}

A creator's profile page in the brand admin area, without pay: name and email, status and who changed it, join date, the brand's notes, who referred them, handles and followers with open account alerts, cross-posting connections, groups, trial progress and a posting-compliance summary. Pay, base-pay overrides, bonus deals and payout accounts are at GET /brands/{brandId}/creators/{creatorId}/pay (payouts:read).

Authorization

bearerAuth creators:read
headerAuthorizationBearer <token>

Personal access token. Scopes: account:read, creator:read, creator:earnings, managed:read, coach:read, brand:read, creators:read, videos:read, analytics:read, recruitment:read, engagement:read, support:read, integrations:read, payouts:read, funds:read, billing:read.

Scope: creators:read

Path Parameters

brandId*string

A brand id from GET /me or GET /creator/brands.

Length1 <= length
creatorId*string

A creator id from GET /brands/{brandId}/creators.

Length1 <= length

Response Body

Success.

application/json
  1. response
id*string
name*string|null
firstName*string|null
lastName*string|null
email*string

The creator's account email, as admins see it.

avatarUrl*string|null
status*string

"trial", "active", "paused" or "archived" (removed from the roster; kept for history).

Value in"trial""active""paused""archived"
statusChangedAt*|

ISO-8601 timestamp.

statusChangedBy*|

The name of the person who last changed the status.

joinedAt*string
updatedAt*string
lastSyncAt*|

ISO-8601 timestamp.

videosRelevantFrom*|

Relevance cutoff: videos posted before this are ignored for this creator. Null when none.

adminNotes*|

The brand's notes on this creator.

adminNotesVisibleToCreator*boolean
referredBy*|

The creator whose invite link they joined through, or null.

hasMarketplaceProfile*boolean

Linked to a Bloss creator profile (needed for reviews).

socials*

The accounts the creator posts from for this brand, per platform.

crossPosting*

The platforms the creator authorized for cross-posting, as last checked. Different from socials[].connected, which only means a handle is on file.

groups*array<>
trial*|

Trial progress while the creator is on trial (as on the profile); full detail at .../trial.

compliance*|

Posting compliance over the last 84 days; null for paused and archived creators. Detail at .../compliance.

curl -X GET 'https://example.com/api/v1/brands/string/creators/string'
{  "id": "string",  "name": "string",  "firstName": "string",  "lastName": "string",  "email": "string",  "avatarUrl": "string",  "status": "trial",  "statusChangedAt": "string",  "statusChangedBy": "string",  "joinedAt": "string",  "updatedAt": "string",  "lastSyncAt": "string",  "videosRelevantFrom": "string",  "adminNotes": "string",  "adminNotesVisibleToCreator": true,  "referredBy": {    "creatorId": "string",    "name": "string",    "email": "string"  },  "hasMarketplaceProfile": true,  "socials": {    "instagram": {      "handle": "string",      "connected": true,      "followers": 0,      "alert": {        "kind": "handle_changed",        "detectedHandle": "string",        "detectedAt": "string"      }    },    "tiktok": {      "handle": "string",      "connected": true,      "followers": 0,      "alert": {        "kind": "handle_changed",        "detectedHandle": "string",        "detectedAt": "string"      }    },    "youtube": {      "handle": "string",      "connected": true,      "followers": 0,      "alert": {        "kind": "handle_changed",        "detectedHandle": "string",        "detectedAt": "string"      }    },    "facebook": {      "handle": "string",      "connected": true,      "followers": 0,      "alert": {        "kind": "handle_changed",        "detectedHandle": "string",        "detectedAt": "string"      }    }  },  "crossPosting": {    "connectedPlatforms": [      "string"    ],    "checkedAt": "string"  },  "groups": [    {      "id": "string",      "name": "string",      "color": "string"    }  ],  "trial": {    "qualifyingVideos": 0,    "videoGoal": 0,    "progressPercent": 0,    "daysRemaining": 0,    "trialEndDate": "string"  },  "compliance": {    "window": {      "from": "string",      "to": "string"    },    "bucket": "over",    "worstPlatform": "instagram",    "daysOverMax": 0,    "weeksUnderMin": 0  }}

Was this page helpful?