Skip to content
SynupAPI
Get an API key
GETapi.synup.com/api/v4/social-post-ideas/image-credits

Image credits

Returns the image-generation credit status for a brand (social profile) — monthly limit, used/remaining this month, and any add-on credit pool.

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Query

NameTypeRequiredDescription
socialProfileIdstringrequiredSocial profile ID.

Headers

NameTypeRequiredDescription
Synup-VersionstringrequiredAPI version date (YYYY-MM-DD).

Request

Request
curl -X GET 'https://api.synup.com/api/v4/social-post-ideas/image-credits?socialProfileId=' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Responses

StatusDescription
200Successful response
401Unauthorized - Invalid or missing API key
Example response (generated from the schema)
{
  "data": {
    "imageCredits": {
      "socialProfileId": "string",
      "monthlyLimit": 0,
      "isActive": true,
      "usedThisMonth": 0,
      "remainingThisMonth": 0,
      "addonPurchased": 0,
      "addonConsumed": 0,
      "addonRemaining": 0
    }
  }
}

Response body

NameTypeRequiredDescription
dataobjectoptional
data.imageCreditsobjectoptional
data.imageCredits.socialProfileIdstringoptional
data.imageCredits.monthlyLimitintegeroptional
data.imageCredits.isActivebooleanoptional
data.imageCredits.usedThisMonthintegeroptional
data.imageCredits.remainingThisMonthintegeroptional
data.imageCredits.addonPurchasedintegeroptional
data.imageCredits.addonConsumedintegeroptional
data.imageCredits.addonRemainingintegeroptional