Skip to content
MothershipDevelopers

API referenceInvoices

List modified invoices

Takes an ISO 8601 timestamp and lists references to the invoices created or modified on or after it.

GET/invoices/modified_since
Environment
https://sandbox.api.mothership.com/beta
curl --request GET \
  --url 'https://sandbox.api.mothership.com/beta/invoices/modified_since?timestamp=2026-03-01T00%3A00%3A00.000Z' \
  --header "Authorization: Bearer $MOTHERSHIP_API_TOKEN" \
  --header 'Accept: application/json'
Reads your token from $MOTHERSHIP_API_TOKEN
Response
{
: {
: [
{
: "9b2e6d41-0c7a-4f3e-8d15-6a4c2e9f1b70",
: "2026-03-02T18:21:07.000Z"
}
],
: true,
: 24,
: 10,
: 1,
: 2
}
}

Hover a key to see what it means. Click it to jump to the field.

Many invoice properties (such as status) are computed and can change frequently depending on a variety of factors. Some events that can cause an invoice to be modified are payments being applied, credits applied, refunds issued, and cancellations processed.

When one of these events occurs, the invoice has effectively been modified. In order to keep your system in sync, this endpoint allows you to list all invoices that have been modified since a start date. Then call Retrieve an invoice for each one.

Pagination

This endpoint is paginated and can return up to 100 invoice references at a time. For your convenience, the response will tell you how many total invoices have been modified since your start date (timestamp) along with the current page you have retrieved and the index of the next page. Don't include the page parameter on the first call.

ParameterRequiredDescription
timestampYesISO timestamp of the on or after date to query.
pageNoA cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the nextPage value returned in a previous response to request subsequent results.
limitNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

Authorization

Authorization: Bearer <token>

Your sandbox API token. See Authentication.

Query parameters

  • pagestring

    Pagination cursor. Leave it out on the first call, then pass the nextPage value from the previous response to get the next page.

  • limitstring

    Number of results to return, from 1 to 100. Defaults to 10.

  • timestampstringRequired

    ISO 8601 timestamp. Invoices created or modified on or after it are returned.

Responses

    • dataobjectRequired
      • invoicesarray of objectsRequired
      • hasMorebooleanRequired

        True if there are more records to fetch.

      • totalnumber

        The total number of invoices that are modified on or after the date.

      • limitnumber

        Number of results requested for this page. The last page can return fewer.

      • currentPagenumber

        Index of this page of results.

      • nextPagenumber

        Index of the next page of results, if there is one.

        nullable

What's next

GETRetrieve an invoice

Retrieve each changed invoice by its id.