Iugu Splits API
The Splits API from Iugu — 4 operation(s) for splits.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/iugu:iugu-splits-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: multi-split Splits API
version: '1.0'
servers:
- url: https://api.iugu.com/v1
security:
- sec0: []
tags:
- name: Splits
paths:
/splits:
post:
summary: Criar Splits
description: Permite a criação de multi splits para uma conta. Criar um novo multi split sobrepõe o que já está configurado. Todas as faturas em aberto em uma conta irão acatar a nova regra de split criada.
operationId: criar-split-1
requestBody:
content:
application/json:
schema:
type: object
properties:
split_rules:
type: array
description: Lista de splits a serém aplicado nas faturas pagas
items:
properties:
recipient_account_id:
type: string
description: ID Da conta que irá receber o split
cents:
type: integer
description: Centavos a serem cobrados da fatura.
format: int32
percent:
type: number
description: Porcentagem a ser cobrada da fatura.
format: float
bank_slip_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações no boleto.
format: int32
bank_slip_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações no boleto.
format: float
credit_card_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações no cartão de crédito.
format: int32
credit_card_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito.
format: float
pix_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações no pix.
format: int32
pix_percent:
type: string
description: Valor em porcentagem a ser cobrado apenas em transações no pix.
permit_aggregated:
type: boolean
description: Permite agregar comissionamento percentual + fixo.
credit_card_1x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 1x no cartão de crédito.
format: int32
credit_card_2x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 2x no cartão de crédito.
format: int32
credit_card_3x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 3x no cartão de crédito.
format: int32
credit_card_4x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 4x no cartão de crédito.
format: int32
credit_card_5x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 5x no cartão de crédito.
format: int32
credit_card_6x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 6x no cartão de crédito.
format: int32
credit_card_7x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 7x no cartão de crédito.
format: int32
credit_card_8x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 8x no cartão de crédito.
format: int32
credit_card_9x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 9x no cartão de crédito.
format: int32
credit_card_10x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 10x no cartão de crédito.
format: int32
credit_card_11x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 11x no cartão de crédito.
format: int32
credit_card_12x_cents:
type: integer
description: Valor em centavos a ser cobrado apenas em transações em 12x no cartão de crédito.
format: int32
credit_card_1x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 1x no cartão de crédito.
format: float
credit_card_2x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 2x no cartão de crédito.
format: float
credit_card_3x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 3x no cartão de crédito.
format: float
credit_card_4x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 4x no cartão de crédito.
format: float
credit_card_5x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 5x no cartão de crédito.
format: float
credit_card_6x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 6x no cartão de crédito.
format: float
credit_card_7x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 7x no cartão de crédito.
format: float
credit_card_8x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 8x no cartão de crédito.
format: float
credit_card_9x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 9x no cartão de crédito.
format: float
credit_card_10x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 10x no cartão de crédito.
format: float
credit_card_11x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 11x no cartão de crédito.
format: float
credit_card_12x_percent:
type: number
description: Valor em porcentagem a ser cobrado apenas em transações em 12x no cartão de crédito.
format: float
type: object
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"id\": \"4322DAFCE8574D058D83E2F8E29F1951\",\n \"splittable_id\": \"27016E1AD888499A98994E781B6C3762\",\n \"splittable_type\": \"Account\",\n \"created_at\": \"2024-05-02T15:33:20-03:00\",\n \"updated_at\": \"2024-05-02T15:33:20-03:00\",\n \"split_rules\": [\n {\n \"id\": \"9EFED8C0B63D417AB5A9964EC21FE265\",\n \"recipient_account_id\": \"8DF741D75DC448CE852BB4687ED28CE6\",\n \"cents\": 100,\n }\n ]\n}"
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
get:
summary: Listar Splits
description: Consulta a lista de splits da conta.
operationId: listar-split
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "[\n {\n \"id\": \"0F143A08D30C4A009E27CD8ED88601C3\",\n \"splittable_id\": \"E255E580AB9B49B087F9FBA07CD0A1A3\",\n \"splittable_type\": \"Account\",\n \"created_at\": \"2020-11-16T17:43:14-03:00\",\n \"updated_at\": \"2020-11-16T17:43:14-03:00\",\n \"split_rules\": [\n {\n \"recipient_account_id\":\"11DA8B1662EC4C30BC4C78AEDC619145\",\n \"cents\":1000\n },\n {\n \"recipient_account_id\":\"0958D2AAD34049AB889583E26DFA0BF1\",\n \"percent\":1.5\n }\n ]\n },\n \t{\n \"id\": \"173188E2F1CC4003A5B3EF11A4A96AB3\",\n \"splittable_id\": \"E255E580AB9B49B087F9FBA07CD0A1A3\",\n \"splittable_type\": \"Account\",\n \"created_at\": \"2020-11-16T18:38:31-03:00\",\n \"updated_at\": \"2020-11-16T18:38:31-03:00\",\n \"split_rules\": [\n {\n \"recipient_account_id\":\"11DA8B1662EC4C30BC4C78AEDC619145\",\n \"cents\":1000\n },\n {\n \"recipient_account_id\":\"0958D2AAD34049AB889583E26DFA0BF1\",\n \"percent\":1.5\n }\n ]\n }\n]"
schema:
type: array
items:
type: object
properties:
id:
type: string
example: 0F143A08D30C4A009E27CD8ED88601C3
splittable_id:
type: string
example: E255E580AB9B49B087F9FBA07CD0A1A3
splittable_type:
type: string
example: Account
created_at:
type: string
example: '2020-11-16T17:43:14-03:00'
updated_at:
type: string
example: '2020-11-16T17:43:14-03:00'
split_rules:
type: array
items:
type: object
properties:
recipient_account_id:
type: string
example: 11DA8B1662EC4C30BC4C78AEDC619145
cents:
type: integer
example: 1000
default: 0
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
/splits/current:
get:
summary: Consultar Split Atual
description: Consulta o split atualmente cadastrado na conta.
operationId: current-split
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"id\": \"0F143A08D30C4A009E27CD8ED88601C3\",\n \"splittable_id\": \"E255E580AB9B49B087F9FBA07CD0A1A3\",\n \"splittable_type\": \"Account\",\n \"created_at\": \"2020-11-16T17:43:14-03:00\",\n \"updated_at\": \"2020-11-16T17:43:14-03:00\",\n \"split_rules\": [\n {\n \"recipient_account_id\":\"11DA8B1662EC4C30BC4C78AEDC619145\",\n \"cents\":1000\n },\n {\n \"recipient_account_id\":\"0958D2AAD34049AB889583E26DFA0BF1\",\n \"percent\":1.5\n }\n ]\n}"
schema:
type: object
properties:
id:
type: string
example: 0F143A08D30C4A009E27CD8ED88601C3
splittable_id:
type: string
example: E255E580AB9B49B087F9FBA07CD0A1A3
splittable_type:
type: string
example: Account
created_at:
type: string
example: '2020-11-16T17:43:14-03:00'
updated_at:
type: string
example: '2020-11-16T17:43:14-03:00'
split_rules:
type: array
items:
type: object
properties:
recipient_account_id:
type: string
example: 11DA8B1662EC4C30BC4C78AEDC619145
cents:
type: integer
example: 1000
default: 0
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
delete:
summary: Remover Split Atual
description: Remove o split atualmente cadastrado na conta.
operationId: remover-split-atual
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"split_rules\": {}\n}"
schema:
type: object
properties:
split_rules:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
/splits/invoices/{id}:
get:
summary: Listar Splits da Fatura
description: Lista a situação atual dos splits da fatura informada.
operationId: listar-splits-da-fatura
parameters:
- name: id
in: path
description: ID da Fatura
schema:
type: string
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "[\n {\n \"account_id\": \"12E559794A794391BBAC265B5F332A1C\",\n \"account_name\": \"Parafuzo\",\n \"amount_cents\": 36,\n \"amount\": \"0.36 BRL\",\n \"paid_at\": \"2022-09-30T21:28:12-03:00\"\n }\n]"
schema:
type: array
items:
type: object
properties:
account_id:
type: string
example: 12E559794A794391BBAC265B5F332A1C
account_name:
type: string
example: Parafuzo
amount_cents:
type: integer
example: 36
default: 0
amount:
type: string
example: 0.36 BRL
paid_at:
type: string
example: '2022-09-30T21:28:12-03:00'
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
/splits/{id}:
get:
summary: Buscar Split
description: Consulta um splits da conta.
operationId: buscar-split
parameters:
- name: id
in: path
description: ID do Split
schema:
type: string
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"id\": \"0F143A08D30C4A009E27CD8ED88601C3\",\n \"splittable_id\": \"E255E580AB9B49B087F9FBA07CD0A1A3\",\n \"splittable_type\": \"Account\",\n \"created_at\": \"2020-11-16T17:43:14-03:00\",\n \"updated_at\": \"2020-11-16T17:43:14-03:00\",\n \"split_rules\": [\n {\n \"recipient_account_id\":\"11DA8B1662EC4C30BC4C78AEDC619145\",\n \"cents\":1000\n },\n {\n \"recipient_account_id\":\"0958D2AAD34049AB889583E26DFA0BF1\",\n \"percent\":1.5\n }\n ]\n}"
schema:
type: object
properties:
id:
type: string
example: 0F143A08D30C4A009E27CD8ED88601C3
splittable_id:
type: string
example: E255E580AB9B49B087F9FBA07CD0A1A3
splittable_type:
type: string
example: Account
created_at:
type: string
example: '2020-11-16T17:43:14-03:00'
updated_at:
type: string
example: '2020-11-16T17:43:14-03:00'
split_rules:
type: array
items:
type: object
properties:
recipient_account_id:
type: string
example: 11DA8B1662EC4C30BC4C78AEDC619145
cents:
type: integer
example: 1000
default: 0
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Splits
components:
securitySchemes:
sec0:
type: apiKey
in: query
name: api_token
x-readme-fauxas: true
x-provenance:
method: searched
source: https://dev.iugu.com/reference
harvested: '2026-10-14'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://dev.iugu.com/reference/buscar-split.md
- https://dev.iugu.com/reference/criar-split-1.md
- https://dev.iugu.com/reference/current-split.md
- https://dev.iugu.com/reference/listar-split.md
- https://dev.iugu.com/reference/listar-splits-da-fatura.md
- https://dev.iugu.com/reference/remover-split-atual.md
merge:
pages: 6
deduped: 5
conflicts_kept_first: 0