Skip to main content
GET
/
suppliers
/
search
Search for supplier
curl --request GET \
  --url https://api.nomos.energy/suppliers/search \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "items": [
    {
      "object": "supplier",
      "id": "mp_a0x6jm5h92wde6s5dnuvha4c",
      "name": "Nomos Friends & Family",
      "code": "9903964000002",
      "code_type": "BDEW",
      "country": "DE",
      "created_at": "2021-01-01T00:00:00.000Z"
    }
  ],
  "next_page": "<string>",
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
name
string
required

Name or partial name to search for.

Example:

"Stadtwerke"

​
cursor
string | null
​
limit
number
default:10
Required range: 1 <= x <= 100

Response

Deprecated: Use GET /suppliers with filter[name][contains]= instead. This is a list of all German electricity retailers, which a customer can select as their previous supplier in the checkout process.

​
object
enum<string>
required
Available options:
list
​
items
object[]
required
​
next_page
string | null
​
has_more
boolean
default:false