Skip to main content
GET
/
components
/
v1
/
badge
/
{externalId}
cURL
curl --request GET \
  --url https://api-sandbox.appcharge.com/components/v1/badge/{externalId} \
  --header 'x-publisher-token: <api-key>'
{
  "id": "507f1f77bcf86cd799439011",
  "name": "New Year Celebration",
  "publisherBadgeId": "new_year_celebration",
  "type": "emblem",
  "badgeImageUrl": "https://media.appcharge.com/media/69133d595af23405d8e843a5"
}

Documentation Index

Fetch the complete documentation index at: https://docs.appcharge.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-publisher-token
string
header
required

Publisher token, as displayed in the Publisher Dashboard.

Path Parameters

​
externalId
string
required

External ID that you defined.

Example:

"new_year_ribbon"

Response

Badge details retrieved successfully.

Response schema for an emblem badge.

​
id
string

Badge ID.

Example:

"507f1f77bcf86cd799439011"

​
name
string

Badge name.

Example:

"New Year Celebration"

​
publisherBadgeId
string

Badge ID that you defined.

Example:

"new_year_celebration"

​
type
enum<string>

Badge type.

Available options:
emblem
Example:

"emblem"

​
badgeImageUrl
string<url>

Badge image URL. For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL.

Example:

"https://media.appcharge.com/media/69133d595af23405d8e843a5"