☰
Navigation :

GET /debts/:id

Fetches a debt with the specified id. This id is the one returned by InvisibleCollector when registering a debt.

This request is idempotent.

    curl -XGET \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer 4b1e8df2ff50110ca86e28f2b499facbd78310c9cda0125543ad80ac70cc28d1" \
  https://api.invisiblecollector.com/debts/12345

    require 'invisible_collector'

client = InvisibleCollector::API.new(api_token: '4a415cc660e67d8f4d26d5a7f390183a86fc3a4524ded78dc2448e86c48b2739')
debt = client.debt.get(id)

    import com.ic.invisiblecollector.IcApiFacade;
import com.ic.invisiblecollector.model.Debt;

IcApiFacade apiFacade = new IcApiFacade("56a73507b66cd761caae7547ef2a66fc3a393746ba4bb9a91e303fcb3ceefb98");

String debtId = ...
Debt debt = apiFacade.getDebtFacade().requestDebtInfo(debtId);

    using InvisibleCollectorLib;
using InvisibleCollectorLib.Model;

var ic = new InvisibleCollector("56a73507b66cd761caae7547ef2a66fc3a393746ba4bb9a91e303fcb3ceefb98");
string debtId = ... ;
Debt debt = await ic.GetDebtAsync(debtId);

    iC, err := ic.NewInvisibleCollector("56a73507b66cd761caae7547ef2a66fc3a393746ba4bb9a91e303fcb3ceefb98", ic.InvisibleCollectorUri)

debtId := "6d420a07-736d-4e93-b09c-7f5cca8d8cf3"
// or
debtId := aDebtModel.Id()

var channel = make(chan ic.DebtPair)
go iC.GetDebt(channel, debtId)
p := <-channel

fmt.Println(p.Debt)

    This request will return, for example, the following JSON response:

    {
  "number": "1",
  "id": "1fb0c683-bedc-45be-a88a-ff76da7bf650",
  "customerId": "0d3987e3-a6df-422c-8722-3fde26eec9a8",
  "type": "FT",
  "status": "PENDING",
  "date": "2018-05-02",
  "dueDate": "2019-01-02",
  "netTotal": 1000.0,
  "tax": 200.0,
  "grossTotal": 1200.0,
  "currency": "EUR",
  "items": [
    {
      "name": "an item name",
      "description": "a debt item description",
      "quantity": 3.0,
      "vat": 23.0,
      "price": 15.0
    },
    {
      "name": "another item name",
      "description": "another debt item description",
      "quantity": 4.0,
      "vat": 23.0,
      "price": 20.0
    },
  ],
  "attributes": {
    "name_1": "attribute_1",
    "name_2": "attribute_2"
  }
}

    Endpoint

    GET https://api.invisiblecollector.com/debts/:id

    Response body

    Debt

    Attribute Type Description
    number string The debt number
    id string An unique identifier of this debt
    customerId string The Invisible Collector’s generated id of the customer to whom this debt was issued to.
    type string The type of debt
    status string The current status of this debt
    date date The date this debt was created in ISO 8601 format (YYYY-MM-DD)
    dueDate date The payment expiration date in ISO 8601 format (YYYY-MM-DD)
    netTotal double This debt’s total net total
    tax double The total amount being paid for tax purposes
    grossTotal double The gross total of this debt
    currency string The ISO 4217 currency code.
    items array A list of items included in the transaction
    attributes map A map of custom attributes related with this debt. Each attribute is a string-string key-value pair.

    Item

    Attribute Type Description
    name string The name if the item
    description string A human readable description of the item
    quantity double The amount of items of this type included in the transaction
    vat percentage The percentage being applied to this item for tax purposes
    price double This item’s gross total

    Errors

    This endpoint may return the following errors:

    HTTP Code Description
    401 Unauthorized Invalid credentials were supplied
    404 Not Found The debt was not found.

    Feedback

    If you have a question that needs an answer, please contact support.