Skip to main content
GET
/
customers
Get All Customers
curl --request GET \
  --url https://api.yourjobsearchgenius.ai/v1/customers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "_id": "customer_id",
      "firstName": "John",
      "lastName": "Doe",
      "email": "[email protected]",
      "subscriptionId": "subscription_id"
    }
  ],
  "pagination": {
    "totalCount": 150,
    "totalPages": 15,
    "currentPage": 1,
    "limit": 10,
    "hasNextPage": true,
    "hasPrevPage": false,
    "nextPage": 2,
    "prevPage": null,
    "nextUrl": "https://api.com/v1/customers?page=2&limit=10",
    "prevUrl": null
  },
  "success": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number (default: 1)

Required range: x >= 1
limit
integer
default:10

Number of records per page (default: 10)

Required range: 1 <= x <= 100
email
string

Search by customer email

uniqueCustomerId
string

Search by unique customer ID

accountStatus
enum<string>

Filter by account status

Available options:
active,
inactive
onboardingCompleted
boolean

Filter by onboarding completion status

lastLoginDateFrom
string<date-time>

Filter by last login date range (ISO format)

lastLoginDateTo
string<date-time>

Filter by last login date range (ISO format)

createdAtFrom
string<date-time>

Filter by creation date range (ISO format)

createdAtTo
string<date-time>

Filter by creation date range (ISO format)

lastLoginDaysAgo
integer

Filter users who logged in X days ago

Required range: x >= 0
hasNoContacts
boolean

Filter users with no contacts

hasNoDocuments
boolean

Filter users with no cover letters

hasNoResumes
boolean

Filter users with no resumes

hasNoJobTracking
boolean

Filter users with no tracked jobs

hasNoMockInterviews
boolean

Filter users with no mock interviews

hasNoInterviewResponses
boolean

Filter users with no interview responses

hasNoOfferNegotiations
boolean

Filter users with no offer negotiations

Response

Successfully retrieved customers

data
object[]
pagination
object
success
boolean
Example:

true