Skip to main content
All top-level API resources support bulk fetches through list API methods. These list API methods share a common structure and return the following pagination fields: has_more and next_page. Nomos’s list API methods use cursor-based pagination via the next_page parameter. The next_page value encodes information to continue walking through the list of resources, ensuring no duplicates or missing items. It is important to keep the exact same query parameters you used when starting to iterate through the list.

​
Example

Start by fetching from your list endpoint: 
curl https://api.nomos.energy/suppliers/search?name=Stadtwerke \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
The following response will be returned: 
{
  "object": "list",
  "items": [
    // ...
  ],
  "has_more": true,
  "next_page": "xxxx"
}
Use the next_page value for cursor-based pagination. Important: You must keep the same query parameters as the initial request: 
curl https://api.nomos.energy/suppliers/search?name=Stadtwerke&cursor=xxxx \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'