List published cooperatives (partner)

GET 
/v1/cooperatives

Paginated, filtered, sorted catalogue card. page is one-based; size is capped at 100. Sort tokens: created_at_desc (default), created_at_asc, name_asc, name_desc, share_price_asc, share_price_desc. Min/max share-price filters are interpreted as EUR. Pass include_coordinates=true to add latitude/longitude for map rendering. Send the returned ETag back as If-None-Match to get a 304.

Request

Responses

200

OK

Response Headers

RateLimit-Limit

Requests permitted per minute for the authenticated API client.

RateLimit-Remaining

Requests still available in the current window. The bucket refills continuously, so this rises as you go rather than resetting on a boundary.

RateLimit-Reset

Seconds until the budget is back to its full limit. Not the wait for the next single request — that is Retry-After on a 429.

400

Malformed request — e.g. an unknown sort, dividend_type, or affiliation token.

401

Missing or invalid access token.

403

Token lacks a scope this endpoint requires. The body carries code: INSUFFICIENT_SCOPE and a required_scopes array naming what is missing; the response also carries WWW-Authenticate: Bearer error="insufficient_scope", scope="…". A 403 with code: FORBIDDEN is a different failure and adding scopes will not fix it.

429

Rate limit exceeded — 600 requests a minute per API client. Unlike every other 4xx here, the request itself is fine: sleep for the Retry-After seconds given and resend it unchanged. See https://docs.valueverde.de/docs/rate-limits.

Response Headers

RateLimit-Limit

Requests permitted per minute for the authenticated API client.

RateLimit-Remaining

Requests still available in the current window. The bucket refills continuously, so this rises as you go rather than resetting on a boundary.

RateLimit-Reset

Seconds until the budget is back to its full limit. Not the wait for the next single request — that is Retry-After on a 429.

Retry-After

Seconds to wait before resending. Always at least 1.