# Lytics Segment API

**Canonical:** https://apis.io/apis/lytics/lytics-segment-api/  
**Provider:** Lytics — https://apis.io/providers/lytics/  
**Base URL:** https://api.lytics.io/v2  
**Documentation:** https://docs.lytics.com/reference

Lytics Segment API is one of 34 APIs that [Lytics](https://apis.io/providers/lytics/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Segment. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Segments are named, logical expressions of users. These segments may logically be built using other segments as well. The segment api provides a list of segments built by both the admin, pre-defined segments automatically added to each account as well as custom ones created through the UI. Segments represent a number of concepts: * *Segment* A list of users, users are members (or not) of a segment * *Trigger* As a user enters, or leaves a segment, this is a trigger. Triggers do not have a Size, only a history of events. * *Goal* A segment that also implies conversion. In Lytics App, there are *Goals* that show more prominently in a funnel type interface. * *Dynamic Attribute* A user belonging to a segment describes an attribute about that user. For instance *IsPurchaser* is both an attribute that can help personaliation, as well as a segment. We call these special segments *Aspects* at Lytics. * *Metric* A segment when used exclusively for the purposes of tracking conversions/metric. The Segment resource has the following attributes: | field | DataType | Description | |-------------|------------------|---------------| | id | string | unique id, Lytics assigned | created | Date | Created date | updated | Date | Last Updated Date | kind | string | What Type of segment from list above ["aspect","goal"] or leave empty for "segment". | slug | string | customer-assigned unique id (We auto assigned by slugifying `Name` if not provided). | name | string | Name of this segment | description | string | Long text description (optional) | is_public | bool | Is this segment available as part of user profile api (entity api) | segment_ql | string | Segment QL Logical Expression | tags | []string | List of tags, for organization purposes To see a list of available fields available for segmentation rules see **catalog** api.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/segment` | SegmentList |
| POST | `/api/segment` | Segment Create |
| GET | `/api/segment/{id}` | Segment Fetch |
| PUT | `/api/segment/{id}` | Segment Update |
| DELETE | `/api/segment/{id}` | Segment Delete |
| POST | `/api/segment/size` | SegmentSize |
| POST | `/api/segment/validate` | SegmentValidate |
| GET | `/api/segment/sizes` | SegmentSizes |
| GET | `/api/segment/{segId}/scan` | SegmentScan |
| DELETE | `/api/segment/{segId}/scan` | Segment Batch Delete |
| GET | `/api/segment/{segId}/attribution` | SegmentAttribution |
| GET | `/api/segment/attribution` | SegmentAttributionList |
| GET | `/api/segment/{segId}/fieldinfo` | SegmentFieldInfo |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/openapi/lytics-segment-api-openapi.yml
- **OpenAPI Source** — https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- **Documentation** — https://docs.lytics.com/reference
- **APIReference** — https://docs.lytics.com/reference
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/mcp/lytics-tool-crosswalk.yml
- **OpenAPI Source** — https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx

## Other Lytics APIs (12)

- [Lytics Account API](https://apis.io/apis/lytics/lytics-account-api/)
- [Lytics Account Settings API](https://apis.io/apis/lytics/lytics-account-settings-api/)
- [Lytics Auth API](https://apis.io/apis/lytics/lytics-auth-api/)
- [Lytics Auths API](https://apis.io/apis/lytics/lytics-auths-api/)
- [Lytics Catalog API](https://apis.io/apis/lytics/lytics-catalog-api/)
- [Lytics Connections API](https://apis.io/apis/lytics/lytics-connections-api/)
- [Lytics Content API](https://apis.io/apis/lytics/lytics-content-api/)
- [Lytics Data Models API](https://apis.io/apis/lytics/lytics-datamodels-api/)
- [Lytics Data Upload API](https://apis.io/apis/lytics/lytics-dataupload-api/)
- [Lytics Experience API](https://apis.io/apis/lytics/lytics-experience-api/)
- [Lytics Flows API](https://apis.io/apis/lytics/lytics-flows-api/)
- [Lytics Jobs API](https://apis.io/apis/lytics/lytics-jobs-api/)

## Tags

Segment

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lytics/lytics-segment-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lytics/.