Get Segment

Retrieve a single segment by ID.

GET/segments/{segment_id}

Requires a full_access API key.

Path Parameters

segment_idstringrequired

The segment ID (UUID).

Response Fields

objectstring

Always "segment".

idstring

The segment ID.

namestring

The segment name.

created_atstring

ISO 8601 timestamp.

curl -X GET 'https://api.postflare.app/segments/a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  -H 'Authorization: Bearer re_xxxxxxxxx'

const response = await fetch(
  'https://api.postflare.app/segments/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  {
    headers: {
      'Authorization': 'Bearer re_xxxxxxxxx',
    },
  }
);

const data = await response.json();

Response

{
  "object": "segment",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Newsletter Subscribers",
  "created_at": "2026-01-01T00:00:00.000Z"
}