Skip to main content
GET
/
members
/
{lookup}
Get Member
curl --request GET \
  --url https://api.kardow.com/members/{lookup} \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "member": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizationId": 123,
      "email": "jsmith@example.com",
      "name": "<string>",
      "role": "<string>",
      "approvalStatus": "<string>",
      "profilePicture": "<string>",
      "description": "<string>",
      "customFields": {}
    },
    "subscriptions": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "organizationId": 123,
        "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "<string>",
        "stripeSubscriptionId": "<string>",
        "currentPeriodStart": "2023-11-07T05:31:56Z",
        "currentPeriodEnd": "2023-11-07T05:31:56Z",
        "cancelAt": "2023-11-07T05:31:56Z",
        "canceledAt": "2023-11-07T05:31:56Z",
        "jobsRemaining": 123,
        "metadata": {}
      }
    ],
    "payments": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "organizationId": 123,
        "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "amount": 123,
        "currency": "<string>",
        "status": "<string>",
        "paymentProvider": "<string>",
        "stripeSessionId": "<string>",
        "stripePaymentIntentId": "<string>",
        "metadata": {}
      }
    ],
    "hasValidPaywallSubscription": true
  }
}
Use this endpoint when you need the current state of one member as Kardow sees it.

​
Path Parameter

​
lookup
string
required
Member email or member UUID.

​
Examples

​
Look up a member by email

cURL
curl --request GET \
  --url https://api.kardow.com/members/member%40example.com \
  --header "x-api-key: your-api-key-here"

​
Look up a member by UUID

cURL
curl --request GET \
  --url https://api.kardow.com/members/11111111-1111-1111-1111-111111111111 \
  --header "x-api-key: your-api-key-here"

​
JavaScript example

const response = await fetch(
  "https://api.kardow.com/members/member%40example.com",
  {
    headers: {
      "x-api-key": process.env.KARDOW_API_KEY,
    },
  }
);

const result = await response.json();
console.log(result.data.hasValidPaywallSubscription);

​
Response Shape

​
data.member
object
required
The organization-scoped member record.
​
data.subscriptions
array
required
All subscriptions for the member in this organization.
​
data.payments
array
required
Recorded payments for the member in this organization.
​
data.hasValidPaywallSubscription
boolean
required
Fast summary for paywall checks.

​
Example response

{
  "data": {
    "member": {
      "id": "11111111-1111-1111-1111-111111111111",
      "organizationId": 42,
      "email": "member@example.com",
      "name": "Taylor Member",
      "role": "employee",
      "approvalStatus": "approved",
      "profilePicture": null,
      "description": null,
      "customFields": null
    },
    "subscriptions": [
      {
        "id": "22222222-2222-2222-2222-222222222222",
        "organizationId": 42,
        "userId": "11111111-1111-1111-1111-111111111111",
        "planId": "33333333-3333-3333-3333-333333333333",
        "status": "active",
        "stripeSubscriptionId": "sub_123",
        "currentPeriodStart": "2026-03-10T12:00:00.000Z",
        "currentPeriodEnd": "2026-04-10T12:00:00.000Z",
        "cancelAt": null,
        "canceledAt": null,
        "jobsRemaining": null,
        "metadata": null
      }
    ],
    "payments": [],
    "hasValidPaywallSubscription": true
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Path Parameters

​
lookup
string
required

Member email or member UUID.

Response

Success

​
data
object
required