Postman is a HTTP client for testing web services. This article explains how to make a call to the Codat API using Postman rather than the API Explorer.
If you don't have Postman installed, download it here.
Now complete the following steps in order. Don't worry no coding is required!
Open up a new request in Postman. In the windows application, select the New button in the top left of the screen.
Set up a request to the API to fetch (GET) a full list of the companies you've added to the Codat system.
a. The type of request should be set to
b. The request URL should be set to
https://api-uat.codat.io/companies in UAT or
https://api.codat.io/companies in Production.
Codat expects for the API key to be included in all API requests to the server, Base64 encoded within an 'Authorization' header. You can read more about authorisation in the Authentication section.
a. In the Codat portal, go to Account > Profile > Authorization Header where you can find your API key Base 64 encoded for you.
b. Add a new Header with the Key set to Authorization (note the US spelling) and Value equal to the Basic plus a space and then your Base 64 encoded API key from the previous step.
Your request should now look similar to below:
Select Send to execute your request.
If successful, the response is a JSON object containing a list of the companies you've added to the Codat system.
Updated 5 months ago