Manager API - How to retrieve full invoice details, including client info and custom fields?

1

Hello,

I’ve been exploring the Manager.io API, but I’m a bit stuck. The documentation is very limited, so most of this has been trial and error.

Currently, I’m using this endpoint to fetch invoice information:

http://localhost:55667/api2/sales-invoice-form/key

The response I get includes basic info like issue date, due days, reference, customer ID, line items, and custom fields, for example:

{
    "IssueDate": "2025-08-24T00:00:00",
    "DueDateDays": 40,
    "Reference": "89",
    "Customer": "306cbd06-7dee-48bc-af9f-e885f996afd5",
    "BillingAddress": "xxxxx",
    "Lines": [
        {
            "Item": "85edce84-f75a-4884-867e-69e48e35dc75",
            "LineDescription": "xxxxx",
            "CustomFields": {},
            "CustomFields2": {
                "Strings": {},
                "Decimals": {},
                "Dates": {},
                "Booleans": {},
                "StringArrays": {}
            },
            "Qty": 39.0,
            "SalesUnitPrice": 30.0
        }
    ],
    "HasLineNumber": true,
    "HasLineDescription": true,
    "HasSalesInvoiceFooters": true,
    "SalesInvoiceFooters": ["bce45dd6-bd9d-4ea9-9e20-864d45ba3b3d"],
    "CustomFields": {},
    "CustomFields2": {
        "Strings": {},
        "Decimals": {},
        "Dates": {},
        "Booleans": {},
        "StringArrays": {
            "274cc860-d963-4f79-899c-b6a6c0beff47": ["xxxx"]
        }
    },
    "Key": "798e2d38-fa32-4a65-b638-2d67fa6cbbc2"
}

The problem is that some important info is missing, such as:

  • Client name

  • Client phone number

  • Full description

  • Custom fields

Is there a different endpoint I should be using to get all this information, or is there a way to expand the current response to include these details?

Thanks in advance for any guidance!

2

Hello @mohamedbreky,

Let me address why these fields are missing:

  • Client name. This is a database lookup field based on Customer field. If you supply the Customer field it will be auto populated.

  • Client phone number. Same as the previous point.

  • Full description. There’s no such field. You have Description field, which wasn’t filled for the transaction you just retrieved, so it’s not part of the record. This brings us to the next point, Manager is not a relational database built on rows of tables. Instead, Manager is an object database that uses .json files to store your data. Any empty field is not part of the record.

  • Custom fields. These are not part of the database basic structure, these are user defined fields identified by the key values – UUIDs. To get the keys for these values, you need to retrieve them separately.

Now back to this point:

Actually, if you visited this url, you’d get the entire api2 schema in .json format:

https://{your manager domain}/api2

You can see all available paths and all their required fields from here. It will also show you the different paths for retreiving the keys for all your Custom Fields.

3

Hello, Thanks, i browsed the api and checked the scheme, even parsed it to AI but with no luck, the main thing to achieve here is to get the full invoice info through api, if you can paste here the URL with the parameters structure (including client name, description, custom fields) that will be great, because without examples in the docs, it’s still very mysterious and difficult.

4

Unfortunately my friend that wouldn’t work.

I already explained why you don’t need client name and why you need to retrieve the keys for your custom fields.

My best advice to you is to manually create a single invoice with all the fields filled in. Then you can retrieve usin api and the structure will be more clear to you.

If that doesn’t work for you, then maybe you should consider hiring an IT guy with experience using open api.

5

Where can such IT guys be found? I am interested in using the API, but have no IT experience or knowledge.