curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
const subscriberId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.mailgreet.com/api/v1/external/subscribers/${subscriberId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);
import requests
subscriber_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.mailgreet.com/api/v1/external/subscribers/{subscriber_id}',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())
<?php
$subscriberId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.mailgreet.com/api/v1/external/subscribers/{$subscriberId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY'
]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
{
"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"
}
}
{
"success": false,
"error": "Subscriber not found"
}
{
"success": false,
"error": "Invalid or missing API key"
}
Subscribers
Get Subscriber
Retrieve detailed information about a specific subscriber
GET
/
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"
const subscriberId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.mailgreet.com/api/v1/external/subscribers/${subscriberId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);
import requests
subscriber_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.mailgreet.com/api/v1/external/subscribers/{subscriber_id}',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())
<?php
$subscriberId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.mailgreet.com/api/v1/external/subscribers/{$subscriberId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY'
]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
{
"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"
}
}
{
"success": false,
"error": "Subscriber not found"
}
{
"success": false,
"error": "Invalid or missing API key"
}
Overview
Retrieve complete details about a specific subscriber including their profile information, group memberships, custom fields, and notes.Authentication
Bearer token. Format:
Bearer YOUR_API_KEYPath Parameters
The unique identifier (UUID) of the subscriber.Example:
550e8400-e29b-41d4-a716-446655440000Response
Indicates if the request was successful
Show Subscriber details
Show Subscriber details
Unique identifier (UUID)
Email address
First name
Last name
Phone number
Subscriber status:
active, unsubscribed, bounced, or complainedObject containing custom field key-value pairs
Array of notes added to the subscriber
ISO 8601 timestamp of creation
ISO 8601 timestamp of last update
curl -X GET "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
const subscriberId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.mailgreet.com/api/v1/external/subscribers/${subscriberId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);
import requests
subscriber_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.mailgreet.com/api/v1/external/subscribers/{subscriber_id}',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())
<?php
$subscriberId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.mailgreet.com/api/v1/external/subscribers/{$subscriberId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY'
]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
{
"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"
}
}
{
"success": false,
"error": "Subscriber not found"
}
{
"success": false,
"error": "Invalid or missing API key"
}
⌘I

