List municipal services

Endpoint used to retrieve the municipal services available for invoice issuance.

This request returns the services registered for the account's municipality and helps identify which service must be informed when scheduling the invoice.

Query parameters

  • offset - Defines the starting position of the listing.

  • limit - Defines the number of records returned per request. The maximum limit is 100.

  • description - Allows filtering services by name or description.

How to interpret the response

Each service usually contains information such as:

  • id - Unique identifier of the municipal service in Asaas.

  • description - Service description. In many cases, this field already includes the municipal code.

📘

Attention

When the municipality provides a service list, it is recommended to use the id returned by this listing in the municipalServiceId field when scheduling the invoice.

  • In this scenario, it is not necessary to repeat the code in municipalServiceCode.
  • Incorrectly filling in the municipal service may cause invoice issuance failures.

Importance of the query

This endpoint is useful to avoid incorrect manual filling of the municipal service.

Query Params
integer
integer
≤ 100
string
Responses

403

Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json