Fetch the logo

GET

/api/bcid/v1/logos/{id}

Returns the reviewed logo as PNG. Use the identity.logo_id from a verified response. The id is a content address, so the image never changes under it. Cache it. The response carries Cache-Control: public, max-age=31536000, immutable. No API credit is charged. Artwork still in review is not served.

Request

Authorization

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Path Params

Header Params

Responses

🟢200The logo

application/octet-stream

The reviewed logo as PNG.

Headers

🟠400Malformed logo id

🟠401Missing or wrong API key

🟠404No published logo has this id

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.callerapi.com/api/bcid/v1/logos/bab28c367e87d8cf' \
--header 'x-auth: <api-key>'

Response Example

400 - Malformed logo id

{
  "status": "error",
  "message": "malformed logo id"
}

Modified at 2026-09-21 16:02:45

Verify the calling number

Announce a call