1. Retail
Kapitale
  • Integration Guide
    • πŸ“‹ Introduction
    • πŸ” Authentication
    • πŸš€ Integration Flow
    • πŸ”” Webhooks
    • πŸ”„ Integration Flowchart
    • πŸ§ͺ Sandbox Environment
    • πŸ“Š Status Map
    • ⚠️ Error Handling
    • πŸ“ Practical Examples
    • πŸ’³ Receivable Consultation
    • πŸ“ž Support
  • API
    • Retail
      • Fetch retail information by CNPJ
        GET
    • Orders
      • Create a new order
      • List orders
      • Fetch order by ID
      • Set payment invoice
      • Cancel order
    • Receivable
      • Fetch receivables by CNPJ
  • Schemas
    • CreateOrderRequest
    • RetailInfo
    • Acquirer
    • CancelOrderRequest
    • PurchaseItem
    • Order
    • FindReceivableResponse
    • OrderStatus
    • PaymentStatus
    • FindByIndustryCnpjResponse
    • OrderStatistics
    • Error
    • ReceivableItem
  1. Retail

Fetch retail information by CNPJ

Partners Integration - Production
https://partners.kapitale.com.br/v1
Partners Integration - Production
https://partners.kapitale.com.br/v1
GET
/company/cnpj/{cnpj}
Returns retail data by CNPJ. This endpoint should be used before creating an order. If the retail is registered in the system, returns database data. Otherwise, fetches data from the credit bureau (Procob). Scope: cnpj.read

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Responses

🟒200
application/json
Retail information returned successfully
Body

🟠400BadRequest
🟠401Unauthorized
πŸ”΄500InternalServerError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://partners.kapitale.com.br/v1/company/cnpj/12345678000190' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Registered retail
{
    "name": "Retail Company LTDA",
    "retail_representative": "John Smith",
    "email": "contact@retail.com",
    "phone": "11987654321",
    "address": "Main Street",
    "number": "123",
    "neighborhood": "Downtown",
    "city": "SΓ£o Paulo",
    "state": "SP",
    "complement": "Room 45",
    "zip_code": "01310-100",
    "registered_retail": true
}
Modified atΒ 2026-03-19 13:59:13
Previous
πŸ“ž Support
Next
Create a new order
Built with