List obligations

GET

/obligations

const url = 'https://api.europlaybook.com/v1/obligations?limit=50&jurisdiction=NL';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.europlaybook.com/v1/obligations?limit=50&jurisdiction=NL' \
  --header 'Authorization: Bearer <token>'

EPR obligations per company, country and regime, with the status per derived year and why.

Authorizations

BearerTokenAuth

Parameters

Query Parameters

cursor

Any of:

string
null

string

Opaque cursor from next_cursor of the previous page.

limit

Limit

Items per page (1-200).

integer

default: 50 >= 1 <= 200

Items per page (1-200).

legal_entity_id

Any of:

string
null

string format: uuid

jurisdiction

Any of:

string
null

string

Examples

status

Any of:

string
null

string

Responses

200

application/json

ObligationPage

object

items

required

Items

Array<object>

ObligationOut

object

required

string format: uuid

legal_entity_id

required

Legal Entity Id

string format: uuid

jurisdiction

required

Jurisdiction

string

regime

required

Regime

string

scope

required

Scope

string

status

required

Status

Shown status (see years for every derived year).

string

status_source

required

Status Source

Rule = derived; user = overridden by a person.

string

status_reason

required

Status Reason

string

status_year

Any of:

integer
null

integer

since

Any of:

string
null

string format: date

pack_version

required

Pack Version

string

years

Years

Array<object>

default:

ObligationYearOut

object

year

required

Year

integer

status

required

Status

Needed, not_needed, unknown, … for that year.

string

reason_code

required

Reason Code

Stable code of the rule outcome.

string

reason_params

Reason Params

object

key

additional properties

any

status_reason

required

Status Reason

The reason in English.

string

rule_key

required

Rule Key

Knowledge-pack rule the status rests on.

string

verified

required

Verified

The rule and its figures are verified against sources.

boolean

next_cursor

Any of:

string
null

string

Example

{
  "items": [
    {
      "id": "0199f5a2-7c1e-7b4a-9d0e-3f6c2a1b8e44",
      "jurisdiction": "NL",
      "regime": "epr.packaging",
      "status": "needed",
      "years": []
    }
  ],
  "next_cursor": "WyIwMTk5ZjVhMi03YzFlLTdiNGEtOWQwZS0zZjZjMmExYjhlNDQiXQ"
}

400

Bad Request

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}

401

Unauthorized

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}

403

Forbidden

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}

404

Not Found

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}

409

Conflict

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}

422

Unprocessable Content

application/json

PublicValidationErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

errors

Errors

Per-field problems (pydantic format: loc, msg, type).

Array<object>

default:

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  },
  "errors": []
}

429

Too Many Requests

application/json

PublicErrorOut

object

detail

required

Detail

What went wrong, in English, for people and logs.

string

code

required

Code

Stable machine-readable error code; translate and branch on this.

string

params

Any of:

object
null

object

key

additional properties

any

Example

{
  "detail": "This API key lacks the scope catalogue:write",
  "code": "insufficient_scope",
  "params": {
    "required_scope": "catalogue:write"
  }
}