---
title: "Obter cliente"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/obter-cliente-1"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Obter cliente

`GET` `/customers/{customer_id}`

Operation ID: `obter-cliente-1`

## Path parameters

- `customer_id` (string, required) - Código do cliente. Formato `cus_XXXXXXXXXXXXXXXX`.

## Responses

- `200` - 200
- `404` - 404

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /customers/{customer_id}:
    get:
      summary: Obter cliente
      description: ""
      operationId: obter-cliente-1
      parameters:
        - name: customer_id
          in: path
          description: Código do cliente. Formato `cus_XXXXXXXXXXXXXXXX`.
          schema:
            type: string
          required: true
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                        "id": "cus_6l5dMWZ0hkHZ4XnE",
                        "name": "Wonderful Woman",
                        "email": "wonderfulwoman@avengers.com",
                      	"gender": "female",
                        "delinquent": false,
                        "address": {
                            "id": "addr_ONzp3ZbTvfDJ35k9",
                            "line_1": "375, Av. General Justo, Centro",
                            "line_2": "8º andar",
                            "zip_code": "20021130",
                            "city": "Rio de Janeiro",
                            "state": "RJ",
                            "country": "BR",
                            "status": "active",
                            "created_at": "2017-08-22T19:50:44Z",
                            "updated_at": "2017-08-22T19:50:44Z"
                        },
                        "created_at": "2017-08-22T19:50:44Z",
                        "updated_at": "2017-08-22T19:50:51Z",
                        "phones": {},
                        "metadata": {
                            "company": "Avengers"
                        }
                    }
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: cus_6l5dMWZ0hkHZ4XnE
                  name:
                    type: string
                    example: Wonderful Woman
                  email:
                    type: string
                    example: wonderfulwoman@avengers.com
                  gender:
                    type: string
                    example: female
                  delinquent:
                    type: boolean
                    example: false
                    default: true
                  address:
                    type: object
                    properties:
                      id:
                        type: string
                        example: addr_ONzp3ZbTvfDJ35k9
                      line_1:
                        type: string
                        example: 375, Av. General Justo, Centro
                      line_2:
                        type: string
                        example: 8º andar
                      zip_code:
                        type: string
                        example: "20021130"
                      city:
                        type: string
                        example: Rio de Janeiro
                      state:
                        type: string
                        example: RJ
                      country:
                        type: string
                        example: BR
                      status:
                        type: string
                        example: active
                      created_at:
                        type: string
                        example: 2017-08-22T19:50:44Z
                      updated_at:
                        type: string
                        example: 2017-08-22T19:50:44Z
                  created_at:
                    type: string
                    example: 2017-08-22T19:50:44Z
                  updated_at:
                    type: string
                    example: 2017-08-22T19:50:51Z
                  phones:
                    type: object
                    properties: {}
                  metadata:
                    type: object
                    properties:
                      company:
                        type: string
                        example: Avengers
        "404":
          description: "404"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                        "message": "Customer not found."
                    }
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Customer not found.
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```