Get Customers by Seller Id - Regional API GetNet

List Customers for a specific Seller

This endpoint retrieves a paginated list of registered customers associated with a specific seller. It is typically used for customer management, recurrence billing, or administrative queries within the Getnet platform.

Usage Scenarios:
- Viewing all customers created under a given seller account.
- Performing administrative tasks such as customer record management or audit logging.
- Validating if a customer is already registered before attempting to create or update their data.

Notes:
- Requires the x-seller-id header to identify the seller making the request.
- The query supports pagination via the page and limit parameters.
- The endpoint returns a structured list of customers including their IDs and registered attributes (e.g., name, document type, email).

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "customers": [
        {
            "customer_id": "string",
            "first_name": "string",
            "last_name": "string",
            "document_type": "CPF",
            "document_type_name": "string",
            "document_number": "string",
            "document_country": "string",
            "phone_number": "string",
            "celphone_number": "string",
            "email": "string",
            "status": "active"
        }
    ],
    "page": 0,
    "limit": 0,
    "total": 0
}

🟠400

🟠404

🟠422

🔴500