AT&T API_COMMON_CATALOG_POC

Retrieve a Promotion by id and version

Version 1.0.1
download iconDownload spec

Endpoint

GET
https://catalog-capability.dev.att.com/direct/promotions/{id}/{version}

This endpoint retrieves a specific Promotion by its ID and version. It provides detailed information about the specified promotion.

arrowSecurity

http

Bearer token using a JWT
scheme:bearer
bearerFormat:JWT
arrowRequest

Path Parameters

      Body Parameters

      Responses

      OK

      arrowBody

      application/json

      REQUEST

      1
2
3
      curl --request GET \
     --url https://catalog-capability.dev.att.com/direct/promotions/string/string \
     --header 'accept: application/json'

      RESPONSE

      1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
      {
  "status": 0,
  "timestamp": "2025-06-12T12:30:03.364Z",
  "responseData": {
    "id": "string",
    "name": "string",
    "description": "string",
    "href": "string",
    "version": "string",
    "validFor": {
      "startDateTime": "2024-03-20T09:12:28Z",
      "endDateTime": "2024-03-20T09:12:28Z"
    },
    "lifecycleStatus": "InDesign",
    "statusReason": "string",
    "lastUpdate": "2025-06-12T12:30:03.364Z",
    "promotionType": "Award",
    "category": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "href": "string",
        "version": "string",
        "@type": "string",
        "@schemaLocation": "string",
        "@referredType": "string"
      }
    ],
    "pattern": [
      {
        "action": [
          {
            "actionType": "ProductOffering",
            "actionValue": "string",
            "actionEntityRef": {
              "id": "string",
              "name": "string",
              "version": "string"
            }
          }
        ],
        "criteriaGroupLogicalRelationship": "string",
        "criteriaGroup": [
          {
            "id": "string",
            "criteriaLogicalRelationship": "string",
            "criteria": {
              "type": "object"
            }
          }
        ]
      }
    ],
    "@type": "string",
    "@schemaLocation": "string"
  }
}