User

Execute segment filters → companies

Changed on Jul 26, 2026

Resolves filters_json only against the immutable corporate company_public_v2 sidecar and returns at most 500 rows. count is the number of rows in this bounded response, not an exact global total. Invalid/legacy filters return 400, unsupported indexed combinations return 422, and missing authority/sidecar or query failure returns 503. This mutation has no request body.

post/api/v1/user/segments/{id}/run

Request

Base URL
https://openmercantil.es
Auth
API key in cookie ob_sess
TypeScript
https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/user/segments/:id/run/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idinteger required

Query parameters

limitinteger

Headers

X-CSRF-Tokenstring required

Fresh token returned by GET /api/v1/user/me for this authenticated session.

Response

Bounded result rows; count equals rows.length and is not a global total

segment_idinteger required

countinteger required

Number of rows returned in this bounded response. It is not an exact global match count.

Example response

{
  "rows": [
    {
      "slug": "mercadona-sa",
      "name": "MERCADONA SA",
      "cif": "A46103834"
    }
  ]
}

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  added the new required header request parameter X-CSRF-Token
- warning
  for the path request parameter id, the min was set to 1.00
- warning
  for the query request parameter limit, the min was set to 1.00
- info
  api operation id postUserSegmentsByIdRun was added
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status

Operation history