---
title: "Retrieves a single segment by its code for an import."
method: GET
path: "/imports/{importId}/segments/code/{segmentCode}"
tags: ["v1"]
---

# Retrieves a single segment by its code for an import.

`GET /imports/{importId}/segments/code/{segmentCode}`

Retrieves a single segment for a given import. The segment is identified by its code.

## Path parameters

- `importId` string, uuid, required
- `segmentCode` string, required

## Response `200`

- Segment
  - `id` string, uuid, required
  - `code` string, required
  - `name` string, required
  - `importId` string, uuid, required
  - `description` string
  - `cpm` number, double
  - `categories` string[]
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Invalid value for: path parameter importId
- `default`

---

[API](https://skmtc.dev/permutive/apis/custom-cohort-segmentation-api.md) · [All operations](https://skmtc.dev/permutive/apis/custom-cohort-segmentation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/permutive/custom-cohort-segmentation-api/revisions/9fb06b4e8a44/schema)