Skip to main content
GET
https://api.mailgreet.com
/
api
/
v1
/
external
/
subscribers
/
{subscriberId}
curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "status": "active",
    "groups": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Newsletter"
      },
      {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "name": "Product Updates"
      }
    ],
    "custom_fields": {
      "company": "Acme Inc",
      "role": "Marketing Manager",
      "signup_source": "website"
    },
    "notes": [
      {
        "id": "note-uuid",
        "content": "VIP customer - prioritize support",
        "created_at": "2026-01-15T10:30:00Z"
      }
    ],
    "created_at": "2026-01-13T12:00:00Z",
    "updated_at": "2026-01-18T14:00:00Z"
  }
}

​
Overview

Retrieve complete details about a specific subscriber including their profile information, group memberships, custom fields, and notes.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
subscriberId
string
required
The unique identifier (UUID) of the subscriber.Example: 550e8400-e29b-41d4-a716-446655440000

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "status": "active",
    "groups": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Newsletter"
      },
      {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "name": "Product Updates"
      }
    ],
    "custom_fields": {
      "company": "Acme Inc",
      "role": "Marketing Manager",
      "signup_source": "website"
    },
    "notes": [
      {
        "id": "note-uuid",
        "content": "VIP customer - prioritize support",
        "created_at": "2026-01-15T10:30:00Z"
      }
    ],
    "created_at": "2026-01-13T12:00:00Z",
    "updated_at": "2026-01-18T14:00:00Z"
  }
}