Customers

The Customers API allows you to retrieve customer records linked to your integration via two endpoints:

• One for retrieving details for a specific customer.

• One for retrieving a paginated list of customers.

You must include your Bearer token in the request header.

Retrieve a paginated list of customers

get

https://public-api.gurupay.euhttps://public-api-dev.gurupay.eu

/api/v1/customers

Returns a list of customers, paginated according to the 'per_page' and 'page' query parameters.

Authorizations

BearerAuth

AuthorizationstringRequired

Authentication using a Bearer token.

Query parameters

per_pageinteger · min: 1 · max: 100Optional

Number of items to return per page in a paginated response.

Default: 15

pageinteger · min: 1Optional

The current page number for paginated results.

Default: 1

Responses

200

A paginated array of customer resources

application/json

401

Unauthorized

application/json

get

/api/v1/customers

HTTPcURLJavaScriptPython

GET /api/v1/customers HTTP/1.1
Host: public-api.gurupay.eu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "identity_uuid": "123e4567-e89b-12d3-a456-426614174000",
    "type": "individual",
    "updated_at": 1744373843,
    "created_at": 1744373843,
    "name": "John Doe",
    "risk_country_code": null,
    "registration_country_code": "LT",
    "registration_address_line": "Business Street 1",
    "registration_address_index": "01109",
    "post_address_country_code": "LT",
    "post_address_line": "Main Street 123",
    "post_address_index": "90210",
    "related_persons": null
  }
]

Retrieve details for a specific customer

get

https://public-api.gurupay.euhttps://public-api-dev.gurupay.eu

/api/v1/customers/{uuid}

Returns comprehensive information about a customer identified by their unique UUID.

Authorizations

BearerAuth

AuthorizationstringRequired

Authentication using a Bearer token.

Path parameters

uuidstring · uuidRequired

Universally Unique Identifier (UUID) as defined by RFC 4122.

Example: e1f8a3b1-7d6c-4e9a-9b2e-3f8d1a9c5f2gPattern: ^[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12}$

Responses

200

Detailed information about the requested customer.

application/json

uuidstring · uuidOptional

The customer's unique identifier.

identity_uuidstring · uuidOptional

The unique identifier of the associated identity

typestring · enumOptional

The category of customer (e.g., individual, company).

Possible values:

updated_atinteger · int64Optional

A Unix timestamp in seconds.

Example: 1744373843

created_atinteger · int64Optional

A Unix timestamp in seconds.

Example: 1744373843

namestring · max: 255Optional

The full name of the customer.

Example: John Doe

risk_country_codenullOptional

The country code indicating the customer's risk level. Not used

registration_country_codestring · max: 2 · nullableOptional

The country code where the company is officially registered.

Example: LT

registration_address_linestring · max: 255 · nullableOptional

The main street address for the company's official registration.

Example: Business Street 1

registration_address_indexstring · max: 20 · nullableOptional

The postal code or zip code for the company's official registration address.

Example: 01109

post_address_country_codestring · max: 2 · nullableOptional

The country code where the company is physically located.

Example: LT

post_address_linestring · max: 255 · nullableOptional

The main street address for the company's physical location.

Example: Main Street 123

post_address_indexstring · max: 20 · nullableOptional

The postal code or zip code for the company's physical location.

Example: 90210

related_personsnullOptional

Information about individuals associated with this customer. Not used

401

Unauthorized

application/json

404

Not Found

application/json

get

/api/v1/customers/{uuid}

HTTPcURLJavaScriptPython

GET /api/v1/customers/{uuid} HTTP/1.1
Host: public-api.gurupay.eu
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "identity_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "type": "individual",
  "updated_at": 1744373843,
  "created_at": 1744373843,
  "name": "John Doe",
  "risk_country_code": null,
  "registration_country_code": "LT",
  "registration_address_line": "Business Street 1",
  "registration_address_index": "01109",
  "post_address_country_code": "LT",
  "post_address_line": "Main Street 123",
  "post_address_index": "90210",
  "related_persons": null
}