ChangesChangelog

Changelog

Conta Simples API change history

For conventions, versioning, and breaking change policy, see Changelog conventions.

[2026-06-26]

Added

  • Create VCN endpoint (POST /credit-cards/v1/vcns): issues a virtual card (VCN) for travel bookings (hotel and air) with the booking metadata, returning PAN, CVV and expiration. Requires mTLS in addition to API key/secret authentication. See reference. Coming soon — not yet available in Sandbox/Production.
  • Get account balance endpoint (GET /accounts/v1/balance): returns the available balance for the authenticated company's account in BRL. See reference.

[2026-06-23]

Added

  • Create cost center endpoint (POST /cost-centers/v1/cost-centers): creates a new cost center for the company; name is required and must be unique per company. See reference.
  • Get cost center by ID endpoint (GET /cost-centers/v1/cost-centers/{id}): returns the data of a specific cost center by UUID. See reference.
  • Update cost center endpoint (PATCH /cost-centers/v1/cost-centers/{id}): renames an existing cost center; the new name must be unique within the company. See reference.
  • Delete cost center endpoint (DELETE /cost-centers/v1/cost-centers/{id}): deletes a cost center by UUID; returns 204 on success. See reference.

Deprecated

  • responsible field in GET /cost-centers/v1/cost-centers response: will be removed in a future version. Do not use this field in new integrations. See reference.

[2026-06-18]

Added

  • Update supplier endpoint (PUT /suppliers/v1/suppliers/{id}): updates the name of an existing company supplier; the name field is required and must be unique per company. See reference.
  • Delete supplier endpoint (DELETE /suppliers/v1/suppliers/{id}): deletes an existing company supplier by numeric ID. Returns 204 on success. See reference.

[2026-06-11]

Added

  • Update category name endpoint (PATCH /categories/v1/categories/{id}): renames an existing custom category; only the name field is updated — linked establishments and category type remain unchanged. The new name must be unique within the company. See reference.
  • Delete categories endpoint (DELETE /categories/v1/categories): deletes one or more custom categories in a single request. If a category has linked establishments, supply moveTo to reassign them before deletion — omitting it returns 422. See reference.

[2026-06-03]

Added

  • Partial user update endpoint (PATCH /users/v1/users/{userId}): updates name and/or roleId for an active company user; at least one field required per request. See reference.
  • Adds supplier list endpoint (GET /suppliers/v1/suppliers). See reference.
  • Adds get supplier by ID endpoint (GET /suppliers/v1/suppliers/{id}). See reference.
  • Adds create supplier endpoint (POST /suppliers/v1/suppliers). See reference.

[2026-05-28]

Added

  • List cost centers endpoint (GET /cost-centers/v1/cost-centers): returns all cost centers for the authenticated company. The response includes id, name, companyId, and the optional responsible field with the name and ID of the assigned owner. See reference.

Changed

  • Endpoint PATCH /statements/v1/credit-card/{transactionId}: added costCenterId (UUID) field to classify the transaction by cost center. See reference.

[2026-05-27]

Added

  • Get user by ID endpoint (GET /users/v1/users/{userId}): returns details of a specific company user by UUID v4 identifier; response matches the list item structure (UserDto), with 404 when the user does not belong to the authenticated company.

[2026-05-26]

Added

  • Update card transaction endpoint (PATCH /statements/v1/credit-card/{transactionId}): updates notes, isConciled, and categoryId on a credit card transaction; at least one field required per request.

[2026-05-14]

Changed

  • Card statement endpoint (GET /statements/v1/credit-card): added optional cardIds query parameter (comma-separated string) to filter transactions by one or more cards at once.

[2026-04-28]

Added

  • Create category endpoint (POST /categories/v1/categories): creates a custom category for the company; the name must be unique among the company’s categories.
  • Get category by ID endpoint (GET /categories/v1/categories/{id}): returns a company category by numeric ID; response matches list items (establishments and type).

[2026-04-17]

Added

  • List categories endpoint (GET /categories/v1/categories): returns categories available to the company.

[2026-04-10]

Added

  • Banking statement endpoint (GET /statements/v1/banking): paginated company bank transactions with filters by period, account, category, cost center, status, amount, and responsible user.

[2026-04-02]

Changed

  • Card statement response (GET /statements/v1/credit-card): each item in attachments may include an optional type field with the MIME type (image/jpeg, image/png, or application/pdf) when the file name extension is recognized.

[2026-03-27]

Added

  • Delete user endpoint (DELETE /users/v1/users/{userId}): removes a user from the company by ID.

[2026-03-25]

Added

  • Create user invites endpoint (POST /users/v1/invites): send invites for new users to join the company with email and role.

[2026-03-24]

Added

  • List roles endpoint (/users/v1/roles): returns company roles with profile, permissions (claims), and linked user counts.

[2026-03-23]

Added

  • List user invites endpoint (/users/v1/invites): paginated invites with filters by status and role.

[2026-03-17]

Changed

  • Card statement (/statements/v1/credit-card): documentation updated from POST to GET, with filter parameters (limit, startDate, endDate, types, nextPageStartKey) sent in the query string.

[2026-03-16]

Added

  • Corporate card management endpoints: list with filters, block, and unblock cards.
  • List company users endpoint, with email filter and cursor-based pagination.

[2026-02-25]

Added

  • List credit cards endpoint.

[2026-02-09]

Added

  • Login endpoint for Conta Simples API authentication.

[2026-02-03]

Added

  • Endpoint to download transaction attachments.

[2026-01-19]

Added

  • Card statement endpoint extended with new fields related to attachments.

[2025-10-15]

Added

  • Card statement endpoint.
  • Initial API schema definition for transactions and cards.
Was this page helpful?