Retrieve a single document of a payment

This endpoint is used to retrieve the details of a specific document linked to a payment.

This call should be used when your integration needs to fetch a single document individually, based on both the payment identifier and the document identifier.

Main request parameters

  • id: Unique identifier of the payment in Asaas.

  • documentId: Unique identifier of the document.


Retrieval behavior

  • Returns the document data that matches the provided identifiers.
  • Can be used to validate settings such as file type and availability rule.
  • GET requests must not include a request body.

When to use

Use this endpoint when you need to:

  • retrieve a specific document from a payment
  • validate the data of an already attached file
  • fetch a single item without listing all documents

Next step in the flow

After retrieving the document, your application can:

  • update the document settings
  • delete the document if needed
  • keep the information synchronized in your system
Path Params
string
required
string
required
Responses

403

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

404

Not found

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