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
string
required
Bearer token. Format:
Bearer YOUR_API_KEYPath Parameters
string
required
The unique identifier (UUID) of the subscriber.Example:
550e8400-e29b-41d4-a716-446655440000Response
boolean
Indicates if the request was successful
object
Show Subscriber details
Show Subscriber details
string
Unique identifier (UUID)
string
Email address
string
First name
string
Last name
string
Phone number
string
Subscriber status:
active, unsubscribed, bounced, or complainedobject
Object containing custom field key-value pairs
array
Array of notes added to the subscriber
string
ISO 8601 timestamp of creation
string
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"
}

