---
updatedAt: 2026-04-07T10:11:22.000Z
agentTools:
  siteIndex: https://developers.liveramp.com/llms.txt
  projectIndex: https://developers.liveramp.com/datamarketplace-buyer-api/llms.txt
---

# Enable Data Marketplace segments for distribution

Creates a request for a third-party segment based on your first-party segment, making the segment eligible for distribution via the Activation API. This is limited to 100 segment IDs per request and returns individual status messages for each segment requested.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Data Marketplace Buyer API",
    "description": "API for accessing LiveRamp's Data Marketplace Buyer API",
    "version": "3.4.0"
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "servers": [
    {
      "description": "",
      "url": "https://api.liveramp.com/data-marketplace/buyer-api"
    }
  ],
  "tags": [
    {
      "name": "v3/RequestedSegments",
      "description": "(resource)  Data Marketplace segments made eligible for distribution via the Activation API."
    }
  ],
  "paths": {
    "/v3/requested-segments": {
      "post": {
        "tags": [
          "v3/RequestedSegments"
        ],
        "operationId": "Create v3/RequestedSegments",
        "description": "Creates a request for a third-party segment based on your first-party segment, making the segment eligible for distribution via the Activation API. This is limited to 100 segment IDs per request and returns individual status messages for each segment requested.",
        "summary": "Enable Data Marketplace segments for distribution",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/v3RequestedSegmentsInput"
                }
              }
            }
          }
        },
        "responses": {
          "207": {
            "description": "v3/RequestedSegments resources processed, statuses in body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "format": "int64"
                      },
                      "status": {
                        "$ref": "#/components/schemas/StandardError"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandardError"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandardError"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandardError"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandardError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "description": "The standard way for a LiveRamp API client to identify the Org it is operating as is to set the LR-Org-ID HTTP header.",
            "in": "header",
            "name": "lr-org-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Requester's access token, fetched from sso.liveramp.com. e.g. `Bearer $ACCESS_TOKEN`.",
            "in": "header",
            "name": "Authorization",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "v3RequestedSegmentsInput": {
        "type": "object",
        "properties": {
          "segmentId": {
            "type": "integer",
            "format": "int64",
            "description": "Link to v3/Segments resource via its id"
          }
        },
        "required": [
          "segmentId"
        ],
        "description": "Data Marketplace segments made eligible for distribution via the Activation API."
      },
      "StandardError": {
        "type": "object",
        "properties": {
          "httpStatus": {
            "description": "HTTP error status code for this problem",
            "type": "integer",
            "format": "int32"
          },
          "errorCode": {
            "description": "Service specific error code, more granular",
            "type": "string"
          },
          "message": {
            "description": "General, human readable error message",
            "type": "string"
          }
        },
        "required": [
          "httpStatus",
          "errorCode",
          "message"
        ]
      }
    }
  }
}
```