---
updatedAt: 2026-09-01T20:42:06.000Z
---

# Retrieve a segment category sharing relationship

Fetches details of a specific segment category sharing relationship by its ID.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Reference Resources",
    "version": "2.0.0",
    "description": "Buzz API v2"
  },
  "paths": {
    "/shared/segment-categories/{id}": {
      "get": {
        "operationId": "shared_segment_categories_retrieve",
        "description": "Fetches details of a specific segment category sharing relationship by its ID.",
        "summary": "Retrieve a segment category sharing relationship",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "schema": {
              "type": "integer"
            },
            "description": "A unique integer value identifying this segment category sharing.",
            "required": true
          }
        ],
        "tags": [
          "Segments"
        ],
        "security": [
          {
            "nestSessionAuth": []
          },
          {
            "nestBasicAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SegmentCategorySharing"
                }
              }
            },
            "description": "Segment category sharing relationship retrieved successfully."
          },
          "401": {
            "description": "Authentication credentials were not provided."
          },
          "403": {
            "description": "Permission denied."
          },
          "404": {
            "description": "Segment category not found."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SegmentCategorySharing": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "readOnly": true,
            "description": "The unique ID of the sharing relationship."
          },
          "account_id": {
            "type": "integer",
            "description": "Defaults to the account in the active session"
          },
          "shared_account_id": {
            "type": "integer",
            "description": "The account the segment category is shared with."
          },
          "key": {
            "type": "string",
            "description": "Key of the segment category being shared."
          },
          "cpm_cost": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$",
            "nullable": true,
            "description": "The CPM cost for the shared segment category."
          },
          "active": {
            "type": "boolean",
            "default": true,
            "description": "Whether the sharing relationship is active."
          },
          "create_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was first created",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "update_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was last updated",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "alternative_id": {
            "type": "string",
            "nullable": true,
            "description": "An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.",
            "maxLength": 200
          },
          "notes": {
            "type": "string",
            "nullable": true,
            "description": "Free-form notes of up to 255 characters.",
            "maxLength": 255
          }
        },
        "required": [
          "account_id",
          "create_date",
          "id",
          "key",
          "shared_account_id",
          "update_date"
        ]
      }
    },
    "securitySchemes": {
      "nestBasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      },
      "nestSessionAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      }
    }
  },
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "node",
    "ruby",
    "javascript",
    "python",
    "php",
    "java"
  ],
  "servers": [
    {
      "url": "https://{buzz_key}.api.beeswax.com/rest/v2",
      "variables": {
        "buzz_key": {
          "default": "stingersbx",
          "description": "Unique customer ID assigned by the Beeswax"
        }
      }
    }
  ],
  "x-readme": {
    "apply-endpoint-order": true,
    "apply-tag-changes": true
  }
}
```