---
updatedAt: 2026-05-26T21:09:59.000Z
agentTools:
  projectIndex: https://docs.zoop.co/llms.txt
---

# Buscar comprador por CPF/CNPJ

Buscar comprador por CPF/CNPJ  [mTLS](https://docs.zoop.co/v2.5/docs/fazendo-uma-chamada)

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Cadastro e credenciamento",
    "version": "1.2"
  },
  "tags": [
    {
      "name": "Compradores",
      "description": "Pessoas ou empresas que compram dentro do seu marketplace"
    }
  ],
  "paths": {
    "/v1/marketplaces/{marketplace_id}/buyers/search": {
      "parameters": [
        {
          "$ref": "#/components/parameters/marketplaceId"
        },
        {
          "$ref": "#/components/parameters/taxpayerID"
        },
        {
          "$ref": "#/components/parameters/einID"
        }
      ],
      "get": {
        "tags": [
          "Compradores"
        ],
        "summary": "Buscar comprador por CPF/CNPJ",
        "description": "Buscar comprador por CPF/CNPJ  [mTLS](https://docs.zoop.co/v2.5/docs/fazendo-uma-chamada)",
        "responses": {
          "200": {
            "description": "Comprador encontrado",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Buyer"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BuyerResponse404"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://payments.zoop.ws"
    }
  ],
  "components": {
    "schemas": {
      "Buyer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": {
              "id buyer": null
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "new",
              "expired",
              "action_required",
              "pending",
              "enabled",
              "active",
              "disabled",
              "deleted"
            ],
            "example": "active"
          },
          "resource": {
            "type": "string",
            "example": "buyer"
          },
          "account_balance": {
            "type": "number",
            "example": 0
          },
          "current_balance": {
            "type": "number",
            "example": 0
          },
          "first_name": {
            "type": "string",
            "example": "Nome"
          },
          "last_name": {
            "type": "string",
            "example": "Nome"
          },
          "email": {
            "type": "string",
            "example": "email"
          },
          "phone_number": {
            "type": "string",
            "example": " 99999999999"
          },
          "taxpayer_id": {
            "type": "string",
            "example": " 99999999999"
          },
          "birthdate": {
            "type": "string",
            "example": "1900-01-15"
          },
          "description": {
            "type": "string",
            "example": null
          },
          "address": {
            "type": "object",
            "properties": {
              "line1": {
                "type": "string",
                "example": "Endereco"
              },
              "line2": {
                "type": "string",
                "example": "999"
              },
              "line3": {
                "type": "string",
                "example": "APT 999"
              },
              "neighborhood": {
                "type": "string",
                "example": "Downtown"
              },
              "city": {
                "type": "string",
                "example": "Cidade"
              },
              "state": {
                "type": "string",
                "example": "UF"
              },
              "postal_code": {
                "type": "string",
                "example": "10023"
              },
              "country_code": {
                "type": "string",
                "example": "BR"
              }
            }
          },
          "delinquent": {
            "type": "boolean"
          },
          "default_debit": {
            "type": "string",
            "description": "cartão default para compras"
          },
          "default_credit": {
            "type": "string",
            "description": "conta bancaria default para depositios"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "created_at": {
            "type": "string",
            "format": "dateTime",
            "example": "2015-04-17T06:39:52+00:00"
          },
          "updated_at": {
            "type": "string",
            "format": "dateTime",
            "example": "2015-04-17T06:39:52+00:00"
          }
        }
      },
      "BuyerResponse404": {
        "type": "object",
        "description": "Not Found",
        "properties": {
          "status": {
            "type": "string",
            "example": "Not Found"
          },
          "status_code": {
            "type": "string",
            "example": 404
          },
          "type": {
            "type": "string",
            "example": "invalid_request_error"
          },
          "category": {
            "type": "string",
            "example": "resource_not_found"
          },
          "message": {
            "type": "string",
            "example": "Sorry, the buyer you are trying to use does not exist or has been deleted."
          }
        }
      }
    },
    "parameters": {
      "marketplaceId": {
        "name": "marketplace_id",
        "in": "path",
        "description": "ID do marketplace",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "taxpayerID": {
        "name": "taxpayer_id",
        "in": "query",
        "description": "CPF do vendedor",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      "einID": {
        "name": "ein",
        "in": "query",
        "description": "CNPJ do vendedor",
        "required": false,
        "schema": {
          "type": "string"
        }
      }
    }
  }
}
```