List billings

GET

GET https://external-api.lia.com.br/external_api/v1/billings

Query params

NameDescriptionRequiredType
order_idFilter by order_idfalseString
statusFilter by billing statusfalseString
created_at_startFilter by billings created_at greater than or equal to (YYYY-MM-DD)falseString
created_at_endFilter by billings created_at lower than or equal to (YYYY-MM-DD)falseString
finished_at_startFilter by billings finished_at greater than or equal to (YYYY-MM-DD)falseString
finished_at_endFilter by billings finished_at lower than or equal to (YYYY-MM-DD)falseString
cancelation_reasonFilter by cancelation_reasonfalseString
pageNumber of the page you wantfalseInteger
per_pageTotal items per page, max 1000 itens per pagefalseInteger

Example request

curl --location 'https://external-api-sandbox.lia.com.br/external_api/v1/billings?order_id=d6bec5c7-d710-5f7b-b080-502c855cf725&
status=canceled&created_at_start=2024-06-09&page=1&per_page=2
--header 'Authorization: Bearer YOUR_API_TOKEN'

Example response

{
    "results": [
        {
            "amount_cents": 310650,
            "amount_currency": "BRL",
            "bills": [
                {
                    "amount_cents": 50000,
                    "authentication_code": "00000000000000000000000000000004",
                    "bill_type": "down_payment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=870ac6d3-e271-5e2f-8142-4717cba6e06b",
                    "created_at": "2024-06-11T09:36:51.670-03:00",
                    "current_amount_cents": 50000,
                    "disable_penalties_until": null,
                    "due_date": "2024-06-12T23:59:59.999-03:00",
                    "effective_due_date": "2024-06-12T23:59:59.999-03:00",
                    "id": "870ac6d3-e271-5e2f-8142-4717cba6e06b",
                    "original_amount_cents": 50000,
                    "paid_at": "2024-06-11T09:36:53.994-03:00",
                    "payments": [
                        {
                            "amount_cents": 50000,
                            "barcode": null,
                            "barcode_image_url": null,
                            "bill_id": "870ac6d3-e271-5e2f-8142-4717cba6e06b",
                            "created_at": "2024-06-11T09:36:53.737-03:00",
                            "expires_at": "2024-06-12T23:59:59.999-03:00",
                            "id": "aa5339d1-7e3a-5086-8714-ec857283491f",
                            "installments": 1,
                            "paid_amount_cents": 0,
                            "paid_at": null,
                            "payment_method": "credit_card",
                            "refunded_amount_cents": 0,
                            "refunded_at": null,
                            "refused_reason": null,
                            "refused_reason_description": null,
                            "status": "failed",
                            "url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=870ac6d3-e271-5e2f-8142-4717cba6e06b"
                        },
                        {
                            "amount_cents": 50000,
                            "barcode": null,
                            "barcode_image_url": null,
                            "bill_id": "870ac6d3-e271-5e2f-8142-4717cba6e06b",
                            "created_at": "2024-06-11T09:36:53.806-03:00",
                            "expires_at": "2024-06-12T23:59:59.999-03:00",
                            "id": "b14d96d2-203c-593f-9a7f-3f26707f4c03",
                            "installments": 1,
                            "paid_amount_cents": 50000,
                            "paid_at": "2024-06-11T09:36:53.852-03:00",
                            "payment_method": "credit_card",
                            "refunded_amount_cents": 50000,
                            "refunded_at": "2024-07-12T00:00:00.000-03:00",
                            "refused_reason": null,
                            "refused_reason_description": null,
                            "status": "refunded",
                            "url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=870ac6d3-e271-5e2f-8142-4717cba6e06b"
                        }
                    ],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.251-03:00"
                },
                {
                    "amount_cents": 52130,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=97500463-b57f-5827-8da4-08b192a17038",
                    "created_at": "2024-06-11T09:36:51.755-03:00",
                    "current_amount_cents": 58560,
                    "disable_penalties_until": "2024-07-10T23:59:59.999-03:00",
                    "due_date": "2024-07-10T23:59:59.999-03:00",
                    "effective_due_date": "2024-07-10T23:59:59.999-03:00",
                    "id": "97500463-b57f-5827-8da4-08b192a17038",
                    "original_amount_cents": 52130,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.277-03:00"
                },
                {
                    "amount_cents": 52130,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=ffd57509-39b5-5dc5-9c7a-63e50d191c9a",
                    "created_at": "2024-06-11T09:36:51.834-03:00",
                    "current_amount_cents": 57986,
                    "disable_penalties_until": "2024-08-10T23:59:59.999-03:00",
                    "due_date": "2024-08-10T23:59:59.999-03:00",
                    "effective_due_date": "2024-08-12T23:59:59.999-03:00",
                    "id": "ffd57509-39b5-5dc5-9c7a-63e50d191c9a",
                    "original_amount_cents": 52130,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.361-03:00"
                },
                {
                    "amount_cents": 52130,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=a13fe5c7-0873-5952-a457-b681e6381115",
                    "created_at": "2024-06-11T09:36:51.905-03:00",
                    "current_amount_cents": 57482,
                    "disable_penalties_until": "2024-09-10T23:59:59.999-03:00",
                    "due_date": "2024-09-10T23:59:59.999-03:00",
                    "effective_due_date": "2024-09-10T23:59:59.999-03:00",
                    "id": "a13fe5c7-0873-5952-a457-b681e6381115",
                    "original_amount_cents": 52130,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.478-03:00"
                },
                {
                    "amount_cents": 52130,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=40b8be0b-8c86-59dc-b7af-d57cadde48bd",
                    "created_at": "2024-06-11T09:36:51.973-03:00",
                    "current_amount_cents": 56961,
                    "disable_penalties_until": "2024-10-10T23:59:59.999-03:00",
                    "due_date": "2024-10-10T23:59:59.999-03:00",
                    "effective_due_date": "2024-10-10T23:59:59.999-03:00",
                    "id": "40b8be0b-8c86-59dc-b7af-d57cadde48bd",
                    "original_amount_cents": 52130,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.464-03:00"
                },
                {
                    "amount_cents": 52130,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 310650,
                        "amount_currency": "BRL",
                        "cancelation_reason": "refunded_by_company",
                        "created_at": "2024-06-11T09:36:51.619-03:00",
                        "due_day": 10,
                        "finished_at": "2024-06-13T15:43:28.559-03:00",
                        "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
                        "installments": 6,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T17:00:57.851-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=5bfef26e-bf65-5ee4-b80f-1725e8b40c92",
                    "created_at": "2024-06-11T09:36:52.055-03:00",
                    "current_amount_cents": 56405,
                    "disable_penalties_until": "2024-11-10T23:59:59.999-03:00",
                    "due_date": "2024-11-10T23:59:59.999-03:00",
                    "effective_due_date": "2024-11-11T23:59:59.999-03:00",
                    "id": "5bfef26e-bf65-5ee4-b80f-1725e8b40c92",
                    "original_amount_cents": 52130,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-13T15:43:28.374-03:00"
                }
            ],
            "cancelation_reason": "refunded_by_company",
            "created_at": "2024-06-11T09:36:51.619-03:00",
            "due_day": 10,
            "finished_at": "2024-06-13T15:43:28.559-03:00",
            "id": "e839d83b-fd25-565e-87e7-d10dd0fb5994",
            "installments": 6,
            "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
            "origin_billing_id": null,
            "payment_configuration": {
                "allowed_down_payment_methods": [
                    "credit_card"
                ],
                "availability": "archived",
                "down_payment_interest_rate": 0.0299,
                "down_payment_type": "absolute",
                "down_payment_value": 44287.0,
                "expires_in": 24,
                "financed_type": "card",
                "id": "3209b282-560e-5afa-a11b-d3693a57baa3",
                "installments": [
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    7,
                    8,
                    9,
                    10
                ],
                "interest_rate": 0.02,
                "max_down_payment_installments": 4,
                "max_installments": 10,
                "min_installment_amount_cents": 100,
                "payment_methods": [
                    "boleto",
                    "pix",
                    "credit_card"
                ],
                "payment_type": "financed",
                "registration_fee": 0.0197,
                "take_rate_type": "percentage",
                "take_rate_value": 1.0
            },
            "status": "canceled",
            "updated_at": "2024-07-19T17:00:57.851-03:00"
        },
        {
            "amount_cents": 290000,
            "amount_currency": "BRL",
            "bills": [
                {
                    "amount_cents": 290000,
                    "authentication_code": null,
                    "bill_type": "installment",
                    "billing": {
                        "amount_cents": 290000,
                        "amount_currency": "BRL",
                        "cancelation_reason": "down_payment_not_paid",
                        "created_at": "2024-06-11T09:35:48.890-03:00",
                        "due_day": 14,
                        "finished_at": "2024-06-11T09:36:54.061-03:00",
                        "id": "35e47d7f-dd93-57d7-aadc-eb1c86aa15aa",
                        "installments": 1,
                        "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
                        "origin_billing_id": null,
                        "status": "canceled",
                        "updated_at": "2024-07-19T16:59:59.556-03:00"
                    },
                    "checkout_url": "https://pague-sandbox.lia.com.br/parcela/pagamento?bill_id=a0eaf7f8-f15c-50f5-9697-77aaf9135ac6",
                    "created_at": "2024-06-11T09:35:48.964-03:00",
                    "current_amount_cents": 290000,
                    "disable_penalties_until": null,
                    "due_date": "2024-06-14T09:35:48.850-03:00",
                    "effective_due_date": "2024-06-14T09:35:48.850-03:00",
                    "id": "a0eaf7f8-f15c-50f5-9697-77aaf9135ac6",
                    "original_amount_cents": 290000,
                    "paid_at": null,
                    "payments": [],
                    "status": "canceled",
                    "updated_at": "2024-06-11T09:36:54.046-03:00"
                }
            ],
            "cancelation_reason": "down_payment_not_paid",
            "created_at": "2024-06-11T09:35:48.890-03:00",
            "due_day": 14,
            "finished_at": "2024-06-11T09:36:54.061-03:00",
            "id": "35e47d7f-dd93-57d7-aadc-eb1c86aa15aa",
            "installments": 1,
            "order_id": "d6bec5c7-d710-5f7b-b080-502c855cf725",
            "origin_billing_id": null,
            "payment_configuration": {
                "allowed_down_payment_methods": [],
                "availability": "archived",
                "down_payment_interest_rate": null,
                "down_payment_type": null,
                "down_payment_value": 0.0,
                "expires_in": 72,
                "financed_type": null,
                "id": "01bdd3c3-a43d-5d87-b1ff-1b30f5f758fa",
                "installments": [
                    1
                ],
                "interest_rate": 0.0,
                "max_down_payment_installments": null,
                "max_installments": 1,
                "min_installment_amount_cents": 0,
                "payment_methods": [
                    "pix"
                ],
                "payment_type": "upfront",
                "registration_fee": 0.0,
                "take_rate_type": null,
                "take_rate_value": null
            },
            "status": "canceled",
            "updated_at": "2024-07-19T16:59:59.556-03:00"
        }
    ],
    "total_items": 2,
    "total_pages": 1
}