---
updatedAt: 2026-06-05T20:14:09.000Z
---

# Get Content Subject

Retrieve the details of a given content subject

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "version": "1.0",
    "title": "Branded Communications Exchange",
    "termsOfService": "https://firstorion.com/terms-use/",
    "x-logo": {
      "url": "https://firstorion.com/wp-content/themes/salient-child/img/logo-icon-blue.svg",
      "backgroundColor": "rgba(0,0,0,0)",
      "altText": "First Orion Logo"
    },
    "description": "> Please avoid using APIs that are marked `deprecated`. While the functions / endpoints will work for the time being, they will be deprecated in the next major release of the APIs.\n",
    "license": {
      "url": "change this and name",
      "name": "Apache 2.0"
    }
  },
  "servers": [
    {
      "url": "https://api.firstorion.com",
      "description": "Production Environment"
    },
    {
      "url": "https://api.forp-lab.com",
      "description": "Integration Environment"
    }
  ],
  "components": {
    "schemas": {
      "businessId": {
        "type": "string",
        "description": "System generated unique identifier for the business",
        "example": "719d140e-fd6c-4d59-9241-3dee71b38320"
      },
      "Image-status": {
        "type": "string",
        "readOnly": true,
        "description": "Status of the image. Only APPROVED images can be used to brand calls.",
        "enum": [
          "APPROVED",
          "PENDING",
          "REJECTED"
        ],
        "example": "PENDING"
      },
      "contentId": {
        "type": "string",
        "readOnly": true,
        "description": "System generated unique identifier for content",
        "example": "b213e38c-8730-4ce4-21b1-0bead118612v"
      },
      "BusinessContentSubjectsAsset-asset": {
        "type": "object",
        "description": "Content/assets displayed to the end user when branded call is delivered to a phone",
        "properties": {
          "contentId": {
            "type": "string",
            "example": "a813e38c-8730-4ce4-80b1-0bead1186e4d"
          },
          "resellerId": {
            "type": "string",
            "example": "186e4d8c-8730-3dee-80b1-4d59d11880b1"
          },
          "businessId": {
            "type": "string",
            "example": "719d140e-fd6c-4d59-9241-3dee71b38320"
          },
          "type": {
            "type": "string",
            "example": "SUBJECT"
          },
          "status": {
            "$ref": "#/components/schemas/Image-status",
            "example": "APPROVED"
          },
          "lastUpdated": {
            "type": "string",
            "example": "1702249909"
          },
          "lastUpdatedBy": {
            "type": "string",
            "example": "VETTING_ORCHESTRATOR"
          },
          "subject": {
            "type": "string",
            "example": "Your Flight Confirmation"
          },
          "note": {
            "type": "string",
            "example": "Subject note example"
          }
        }
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized"
      },
      "Forbidden": {
        "description": "Forbidden"
      },
      "BusinessNoBodyBadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 400
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "path validation failed for field businessId: value is required"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "PhoneResourceNotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 404
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "rpc error: code = NotFound desc = phone number not found"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Authentication",
      "tags": [
        "Authentication",
        "OAuth2.0"
      ]
    },
    {
      "name": "Businesses",
      "tags": [
        "Businesses",
        "Business Addresses",
        "Business Contacts",
        "Business Images",
        "Business API Keys",
        "Business Units"
      ]
    },
    {
      "name": "Phone Numbers",
      "tags": [
        "Business Phone Numbers",
        "Business Unit Phone Numbers",
        "CallerName aNumbers"
      ]
    },
    {
      "name": "Programs",
      "tags": [
        "Programs",
        "Schedules"
      ]
    },
    {
      "name": "Program Delivery Channels",
      "tags": [
        "Delivery Channels",
        "CallerName",
        "CallerImage",
        "Blocking",
        "Engage SDK"
      ]
    },
    {
      "name": "Call Authentication",
      "tags": [
        "Call Authentication",
        "Call Authentication V2",
        "PreCall Engage SDK"
      ]
    },
    {
      "name": "Reference Data",
      "tags": [
        "Employee Count Ranges",
        "Daily Call Count Ranges",
        "Industries",
        "Call Purposes"
      ]
    },
    {
      "name": "Utilities",
      "tags": [
        "Phone Number Verification"
      ]
    }
  ],
  "paths": {
    "/exchange/v1/businesses/{businessId}/content/subject/{contentId}": {
      "summary": "Business Images",
      "parameters": [
        {
          "name": "Authorization",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "example": "<token>"
          }
        },
        {
          "name": "businessId",
          "in": "path",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/businessId"
          }
        },
        {
          "name": "contentId",
          "in": "path",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/contentId"
          }
        }
      ],
      "get": {
        "summary": "Get Content Subject",
        "description": "Retrieve the details of a given content subject",
        "operationId": "GetContentSubject",
        "tags": [
          "Business Content Subjects"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "body": {
                      "$ref": "#/components/schemas/BusinessContentSubjectsAsset-asset"
                    },
                    "error": {
                      "type": "string",
                      "example": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BusinessNoBodyBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/PhoneResourceNotFound"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```