This collection contains the publicly supported endpoints of the TDT Metrics API. Only the requests included here are considered stable and suitable for client integration.
\nUse the active Postman Environment to set:
\napi_url — API base URL (example: https://api.metrics.tdtglobal.io/api)All requests are executed against:{{api_url}}
Authentication is handled through Keycloak (proxy) via:
\n/auth/loginOn success, the API returns an access_token (JWT).
For protected endpoints, include:
Authorization: Bearer {{token}}Tip: The login request can automatically store the token in your Environment variable token for subsequent calls.
Unless otherwise specified, send:
\nAccept: application/jsonProtected endpoints require:
\nAuthorization: BearerSome endpoints use multipart/form-data (form-data).
Field names may follow a nested format such as:
data[attributes][...]Refer to each endpoint documentation for the exact parameters and types.
\nError responses are returned in JSON. Typical failures include:
\n422 Validation Error (missing/invalid fields)
\n401 Unauthorized (invalid credentials or missing/invalid token)
\n403 Forbidden (access denied)
\n404 Not Found (resource or route not found)
\n503 Service Unavailable (upstream auth provider unavailable / timeout)
\n500 Internal Server Error (unexpected failure)
\nEach endpoint includes examples for common error scenarios.
\nThis collection represents the public contract for client integrations.
Breaking changes (if any) should be communicated ahead of time and versioned accordingly.
required | email
\n"},{"key":"data[attributes][password]","value":"{{password}}","type":"text","description":"required | string
\n"}]},"url":"{{api_url}}/auth/login","description":"Authenticates a user through Keycloak (proxy) and returns an access token (JWT) plus the authenticated user profile (including relationships such as country and roles). Use the returned token to access protected endpoints.
\nThis endpoint does not require an Authorization header (public endpoint).
For protected endpoints, include:
\nAuthorization: BearerMethod: POST
Endpoint: /api/auth/login
Headers:
Accept: application/jsonContent-Type: multipart/form-data (form-data)
Content-Type: application/json
\n\n<p >Token and personal data are shown with generic values.</p>
\n
{\n \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...<truncated>\",\n \"token_type\": \"Bearer\",\n \"expires_at\": \"2026-12-31 23:59:59\",\n \"user\": {\n \"id\": 123,\n \"type\": \"users\",\n \"attributes\": {\n \"name\": \"John\",\n \"last_name\": \"Doe\",\n \"avatar\": null,\n \"email\": \"john.doe@example.com\",\n \"country_id\": 2,\n \"company_id\": 63,\n \"user_type_id\": 1,\n \"timezone\": \"America/Montevideo\",\n \"position\": \"Admin\",\n \"phone_number\": \"+598 9000 0000\",\n \"birthday\": null,\n \"gender\": null,\n \"first_loggin_at\": \"2026-02-05 14:35:18\"\n },\n \"relationships\": {\n \"country\": {\n \"data\": { \"id\": 2, \"type\": \"countries\", \"name\": \"Uruguay\" }\n },\n \"user_type\": {\n \"data\": { \"id\": 1, \"type\": \"user_types\" }\n },\n \"permissions\": { \"data\": [] },\n \"roles\": {\n \"data\": [{ \"id\": 1, \"type\": \"roles\" }]\n }\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/users/123\"\n }\n }\n}\n\nReturned when required fields are missing or incorrectly formatted.
\n{\n \"message\": \"The data.attributes.email field is required. (and 1 more error)\",\n \"errors\": {\n \"data.attributes.email\": [\n \"The data.attributes.email field is required.\"\n ],\n \"data.attributes.password\": [\n \"The data.attributes.password field is required.\"\n ]\n }\n}\n\nReturned when the email or password is incorrect.
\n{\n \"message\": \"Invalid credentials.\"\n}\n\nReturned when the user's access is restricted (disabled, blocked, or not allowed).
\n{\n \"message\": \"Access denied.\"\n}\n\nReturned when the route is incorrect or the requested resource is not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/auth/login' \\\n --header 'Accept: application/json' \\\n --form 'data[attributes][email]=\"{{email}}\"' \\\n --form 'data[attributes][password]=\"{{password}}\"'\n\nFor protected endpoints:
\nAuthorization: Bearer {{token}}required|string|email
\n","disabled":true},{"key":"password","value":"{{password}}","type":"text","description":"required|string
\n","disabled":true}]},"url":"{{api_url}}/auth/service-token","description":"Generates an access token (JWT) for machine-to-machine (M2M) integrations using a service account. Use the returned token to access protected endpoints.
\nThis endpoint does not require an Authorization header (public endpoint).
For protected endpoints, include:
\nAuthorization: BearerMethod: POST
Endpoint: /api/auth/service-token
Headers:
Accept: application/jsonContent-Type: multipart/form-data (form-data)
Content-Type: application/json
\n\nToken and personal data are shown with generic values.
\n
{\n \"message\": \"Service token for API integrations generated\",\n \"data\": {\n \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...<truncated>\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 2592000,\n \"expires_at\": \"2026-03-08 18:06:13\",\n \"scope\": \"profile email\",\n \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...<truncated>\",\n \"refresh_expires_in\": 2592000,\n \"refresh_expires_at\": \"2026-03-08 18:06:13\"\n }\n}\n\nReturned when required fields are missing or incorrectly formatted.
\n{\n \"message\": \"The email field is required. (and 1 more error)\",\n \"errors\": {\n \"email\": [\n \"The email field is required.\"\n ],\n \"password\": [\n \"The password field is required.\"\n ]\n }\n}\n\nReturned when the email or password is incorrect.
\n{\n \"message\": \"Invalid credentials.\"\n}\n\nReturned when the service account is blocked/disabled or access is restricted.
\n{\n \"message\": \"Access denied.\"\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\nrequired | string
\n"}]},"url":"{{api_url}}/auth/service-token/refresh","description":"Refreshes an existing M2M service access token using a valid refresh_token and returns a new access token (and typically a new refresh token) with updated expiration values.
Use the returned token to access protected endpoints:Authorization: Bearer
This endpoint does not require an Authorization header (public endpoint).
The refresh_token is used to validate and refresh the session.
Method: POST
Endpoint: /api/auth/service-token/refresh
Headers:
Accept: application/jsonContent-Type: multipart/form-data (form-data)
Content-Type: application/json
\n\nToken values are shown with generic/truncated values.
\n
{\n \"message\": \"Service token refreshed successfully\",\n \"data\": {\n \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...<truncated>\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 2592000,\n \"expires_at\": \"2026-03-08 18:06:13\",\n \"scope\": \"profile email\",\n \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...<truncated>\",\n \"refresh_expires_in\": 2592000,\n \"refresh_expires_at\": \"2026-03-08 18:06:13\"\n }\n}\n\nReturned when refresh_token is missing or incorrectly formatted.
{\n \"message\": \"The refresh_token field is required.\",\n \"errors\": {\n \"refresh_token\": [\n \"The refresh_token field is required.\"\n ]\n }\n}\n\nReturned when the provided refresh token is invalid, expired, or cannot be verified.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the service account/client is not allowed to refresh tokens or access is restricted.
\n{\n \"message\": \"Access denied.\"\n}\n\nReturned when the route is incorrect or the requested resource is not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\nThis folder contains all authentication endpoints for the TDT Metrics API, implemented as a proxy to Keycloak.
\nIt supports two authentication modes:
\n/api/auth/loginUse this endpoint when a real user signs in (UI / human login).
\nInput: data[attributes][email], data[attributes][password] (form-data)
Output: access_token, token_type, expires_at, and user details
/api/auth/service-tokenUse this endpoint for server-to-server integrations (service account login).
\nInput: email, password (form-data)
Output: access_token, expiration fields, and refresh_token
/api/auth/service-token/refreshUse this endpoint to refresh an existing service session.
\nInput: refresh_token (form-data)
Output: new access_token (and updated expiration fields)
Base URL: {{api_url}}
Default header: Accept: application/json
Tokens must be sent to protected endpoints as:
\nAuthorization: BearerThese endpoints use the following status codes:
\n200 success
\n401 invalid credentials / invalid token
\n403 access denied (blocked/disabled user or restricted access)
\n404 not found (route not available)
\n422 validation error (missing/invalid fields)
\n500 unexpected server error
\noptional | string | es,en,pt
\n","type":"text"},{"key":"data[type]","value":"user_password_resets","type":"text","description":"required | string
\n"},{"key":"data[attributes][email]","value":"dojeda@tolber.io","type":"text","description":"required | string | email
\n"}]},"url":"{{api_url}}/password-resets","description":"Requests a password reset by email. The system will generate a password reset token and send a reset message to the provided email address.
\nThis endpoint does not require an Authorization header (public endpoint).
Method: POST
Endpoint: /api/password-resets
Headers:
Accept: application/jsonContent-Type: multipart/form-data (form-data)
Content-Type: application/json
{\n \"data\": {\n \"id\": 52,\n \"type\": \"user_password_resets\",\n \"attributes\": {\n \"email\": \"john.doe@example.com\",\n \"token\": \"80fzfGv1arcQuteesUS3CsGcZ3dMIDsMzoCu3JA8lnJfE1NPoaS3dyNp05CL9dHP\",\n \"expired_at\": \"2026-02-07 19:55:46\",\n \"used_at\": null\n },\n \"meta\": {\n \"is_expired\": false,\n \"is_used\": false,\n \"is_active\": true\n }\n }\n}\n\nReturned when required fields are missing or incorrectly formatted.
\n{\n \"message\": \"The data.attributes.email field is required.\",\n \"errors\": {\n \"data.attributes.email\": [\n \"The data.attributes.email field is required.\"\n ]\n }\n}\n\nReturned when the route is incorrect or the resource is not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/password-resets' \\\n --header 'Accept: application/json' \\\n --form 'lang=\"en\"' \\\n --form 'data[type]=\"user_password_resets\"' \\\n --form 'data[attributes][email]=\"john.doe@example.com\"'\n\nValidates whether a password reset token is still valid and can be used to set a new password.
\nThis endpoint does not require an Authorization header (public endpoint).
Method: GET
Endpoint: /api/password-resets/:token
Headers:
Accept: application/jsonContent-Type: application/json
{\n \"data\": {\n \"id\": 52,\n \"type\": \"user_password_resets\",\n \"attributes\": {\n \"email\": \"john.doe@example.com\",\n \"token\": \"80fzfGv1arcQuteesUS3CsGcZ3dMIDsMzoCu3JA8lnJfE1NPoaS3dyNp05CL9dHP\",\n \"expired_at\": \"2026-02-07 19:55:46\",\n \"used_at\": null\n },\n \"meta\": {\n \"is_expired\": false,\n \"is_used\": false,\n \"is_active\": true\n }\n }\n}\n\nReturned when the token does not exist, is invalid, or expired.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/password-resets/<token>' \\\n --header 'Accept: application/json'\n\noptional | string | es,en,pt
\n","type":"text"},{"key":"data[type]","value":"user_password_resets","type":"text","description":"required | string
\n"},{"key":"data[attributes][password]","value":"Daniel.2022","type":"text","description":"required | string | email
\n"}]},"url":"{{api_url}}/new-password/:token","description":"Sets a new password using a valid password reset token.
\nThis endpoint does not require an Authorization header (public endpoint).
Method: PATCH
Endpoint: /api/new-password/:token
Headers:
Accept: application/jsonContent-Type: application/x-www-form-urlencoded (urlencoded)
Content-Type: application/json
{\n \"data\": {\n \"id\": 123,\n \"type\": \"users\",\n \"attributes\": {\n \"name\": \"John\",\n \"last_name\": \"Doe\",\n \"avatar\": null,\n \"email\": \"john.doe@example.com\",\n \"country_id\": 2,\n \"company_id\": 92,\n \"user_type_id\": 1,\n \"timezone\": \"America/Montevideo\",\n \"position\": \"Admin\",\n \"phone_number\": \"+598 9000 0000\",\n \"birthday\": null,\n \"gender\": null,\n \"first_loggin_at\": \"2026-02-06 18:04:07\"\n },\n \"relationships\": {\n \"country\": [],\n \"company\": [],\n \"user_type\": [],\n \"permissions\": [],\n \"roles\": []\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/users/123\"\n }\n }\n}\n\nReturned when required fields are missing or invalid.
\n{\n \"message\": \"The company_id field is required. (and 1 more error)\",\n \"errors\": {\n \"company_id\": [\n \"The company_id field is required.\"\n ],\n \"data.attributes.password\": [\n \"The data.attributes.password field is required.\"\n ]\n }\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location --request PATCH '{{api_url}}/change-password' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --data-urlencode 'lang=\"en\"' \\\n --data-urlencode 'company_id=55' \\\n --data-urlencode 'data[type]=\"user_password_resets\"' \\\n --data-urlencode 'data[attributes][password]=\"NewStrongPassword123!\"'\n\noptional | string | es,en,pt
\n","type":"text"},{"key":"company_id","value":"55","type":"text","description":"required | integer
\n"},{"key":"data[type]","value":"user_password_resets","type":"text","description":"required | string
\n"},{"key":"data[attributes][password]","value":"","type":"text","description":"required | string
\n"}]},"url":"{{api_url}}/change-password","description":"Changes the password for the currently authenticated user.
\nThis endpoint requires a valid Bearer token:
\nAuthorization: BearerMethod: PATCH
Endpoint: /api/change-password
Headers:
Accept: application/json
Authorization: Bearer
Content-Type: application/x-www-form-urlencoded (urlencoded)
Content-Type: application/json
{\n \"data\": {\n \"id\": 123,\n \"type\": \"users\",\n \"attributes\": {\n \"name\": \"John\",\n \"last_name\": \"Doe\",\n \"avatar\": null,\n \"email\": \"john.doe@example.com\",\n \"country_id\": 2,\n \"company_id\": 92,\n \"user_type_id\": 1,\n \"timezone\": \"America/Montevideo\",\n \"position\": \"Admin\",\n \"phone_number\": \"+598 9000 0000\",\n \"birthday\": null,\n \"gender\": null,\n \"first_loggin_at\": \"2026-02-06 18:04:07\"\n },\n \"relationships\": {\n \"country\": [],\n \"company\": [],\n \"user_type\": [],\n \"permissions\": [],\n \"roles\": []\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/users/123\"\n }\n }\n}\n\nReturned when the Authorization header is missing or the token is invalid.
{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when required fields are missing or invalid.
\n{\n \"message\": \"The company_id field is required. (and 1 more error)\",\n \"errors\": {\n \"company_id\": [\n \"The company_id field is required.\"\n ],\n \"data.attributes.password\": [\n \"The data.attributes.password field is required.\"\n ]\n }\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location --request PATCH '{{api_url}}/change-password' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --data-urlencode 'lang=\"en\"' \\\n --data-urlencode 'company_id=55' \\\n --data-urlencode 'data[type]=\"user_password_resets\"' \\\n --data-urlencode 'data[attributes][password]=\"NewStrongPassword123!\"'\n\nThis folder contains the full password recovery and password update flow:
\nPOST /api/password-resets → generates a reset token
GET /api/password-resets/:token → validates the token
PATCH /api/new-password/:token → sets a new password
/api/change-password → requires Authorization: BearerBase URL: {{api_url}}
Default header: Accept: application/json
Some requests use form-data and others use x-www-form-urlencoded (see each endpoint).
\nValidation errors follow Laravel’s standard format:
\nmessage + errors object with field paths.Standard status codes used in this folder:
\n200 success
\n401 unauthorized (token missing/invalid) (authenticated endpoint only)
\n403 access denied (permission restrictions) (when applicable)
\n422 validation error
\n404 not found (invalid route or token not found/expired depending on endpoint behavior)
\n500 unexpected server error
\nReset tokens are sensitive. Do not log or expose them in client-side logs.
\nUse HTTPS when calling these endpoints, especially when sending credentials or tokens.
\nRetrieves the full details and results of a single Media Plan execution using its unique identifier (id).
Use this endpoint when you already have a media_plan_id and need the complete output (including computed results, metadata, and related entities depending on the server configuration).
This endpoint requires a valid Bearer token.
\nHeader
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: /api/media-plan/:id
Example
\nGET {{api_url}}/media-plan/:id?lang=en&company_id=55Accept: application/json\n\nNote:
\ncompany_idis required for this API contract.
Returned when the Media Plan exists and the authenticated user has access to it.
\nExample Response (200) (generic values)
\n{\n \"data\": {\n \"id\": 792,\n \"type\": \"evaluation\",\n \"attributes\": {\n \"name\": \"Sample Media Plan Name\",\n \"account_id\": 353,\n \"company_id\": 55,\n \"created_date\": \"2026-02-08\",\n \"user_id\": 103,\n \"token\": {\n \"token\": \"792f5de5d3bcb5e76e4e7ae89313abd168042d8dfaed8ce483f92c70a54199aa...<truncated>\",\n \"created_at\": \"2026-02-08 20:10:32\"\n },\n \"data\": {\n \"goal\": \"{\\\"id\\\":2,\\\"name\\\":\\\"Brand Awareness\\\"}\",\n \"title\": \"Sample Media Plan Title\",\n \"weeks\": 4,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"start_date\": \"2025-03-01 00:00:00\",\n \"end_date\": \"2025-03-31 00:00:00\",\n \"gender\": \"3\",\n \"age_range\": {\n \"min_age\": \"18\",\n \"max_age\": \"55\"\n },\n \"geo_type\": {\n \"id\": 1,\n \"name\": \"city\"\n },\n \"tags\": [\n {\n \"id\": \"001\",\n \"code\": \"001\",\n \"name\": \"Sample Location Name\",\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"city_id\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"region\": \"Gauteng\",\n \"budget\": {\n \"amount\": 11654.98,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"start_date\": \"2025-03-01 00:00:00\",\n \"end_date\": \"2025-03-31 00:00:00\"\n },\n \"ots\": 169719,\n \"cpm\": 2.73,\n \"illumination\": \"yes\",\n \"dimensions\": {\n \"hight\": 59,\n \"width\": 20\n },\n \"classifications\": {\n \"size\": { \"id\": 1, \"name\": \"large\" },\n \"material\": { \"id\": 1, \"name\": \"printed\" },\n \"placeType\": { \"id\": 8, \"name\": \"Urban + Suburban\" },\n \"mediaClass\": { \"id\": 2, \"name\": \"roadside\" }\n }\n }\n ],\n \"countries\": [\n {\n \"name\": \"South Africa\",\n \"iso_code\": \"ZA\",\n \"cities\": [\n {\n \"id\": 2627446,\n \"name\": \"Johannesburg\",\n \"assets\": 6,\n \"coverage\": 81.06,\n \"audience_cpm\": 4.06,\n \"audience_ots\": 16626984,\n \"total_population\": 1550000,\n \"reached_population\": 916789,\n \"average_frequency\": 21.15,\n \"budget\": {\n \"amount\": 67580.31,\n \"iso_currency_code\": \"USD\"\n },\n \"effective_frequency\": [\n { \"name\": \"+1\", \"value\": 81.06 },\n { \"name\": \"+2\", \"value\": 79.2 }\n ]\n }\n ],\n \"all_locations\": {\n \"assets\": 8,\n \"coverage\": 68.42812939521801,\n \"audience_cpm\": 4.6501133094039515,\n \"audience_ots\": 22135409,\n \"total_population\": 3050000,\n \"reached_population\": 1459572,\n \"average_frequency\": 17.67293888208324,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"effective_frequency\": [\n { \"name\": \"+1\", \"value\": 68.42812939521801 },\n { \"name\": \"+2\", \"value\": 66.65738396624472 }\n ]\n }\n }\n ],\n \"behaviors\": [],\n \"interests\": [],\n \"languages\": [],\n \"advertiser\": \"{\\\"advertiser\\\":{\\\"id\\\":353,\\\"name\\\":\\\"Sample Advertiser\\\"},\\\"brand\\\":{\\\"id\\\":317,\\\"name\\\":\\\"Sample Brand\\\"}}\",\n \"socioeconomic_levels\": \"{\\\"min\\\":{\\\"id\\\":3,\\\"name\\\":\\\"medium\\\"},\\\"max\\\":{\\\"id\\\":7,\\\"name\\\":\\\"low_low\\\"}}\"\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": { \"id\": 353, \"type\": \"accounts\" },\n \"links\": { \"self\": \"https://api.example.com/api/accounts/353\" }\n },\n \"company\": {\n \"data\": {\n \"id\": 55,\n \"type\": \"companies\",\n \"name\": \"Sample Company\",\n \"logo\": \"https://cdn.example.com/images/companies/company-55.jpg\",\n \"profile\": { \"id\": 2, \"name\": \"Premium\" }\n },\n \"links\": { \"self\": \"https://api.example.com/api/companies/55\" }\n },\n \"user\": {\n \"data\": { \"id\": 103, \"type\": \"users\" },\n \"links\": { \"self\": \"https://api.example.com/api/users/103\" }\n }\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/media-plan/792\"\n }\n }\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the Media Plan does not exist or is not available for the provided scope.
\n{\n \"message\": \"Media Plan not found.\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/media-plan/<id>?company_id=<company_id>&lang=en' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"pt"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"token","value":"352ca7efadf394b4c96506db589dde84f4e4f21782ef943d4aae1d66333807b78b7c18ec13fba22e4ceb50d01c73efce941"}],"variable":[{"type":"any","value":"792","key":"id"}]}},"response":[{"id":"c0369ddd-6906-47bf-9470-13547813af10","name":"200 OK — Get media plan by id","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{api_url}}/media-plan/:id?lang=pt&company_id=55","host":["{{api_url}}"],"path":["media-plan",":id"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"token","value":"352ca7efadf394b4c96506db589dde84f4e4f21782ef943d4aae1d66333807b78b7c18ec13fba22e4ceb50d01c73efce941","description":"optional | string","disabled":true}],"variable":[{"key":"id","value":"792"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 15:35:36 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"9c5ce013-0987-4f25-95ba-04b4c6fb5954"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": 792,\n \"type\": \"evaluation\",\n \"attributes\": {\n \"name\": \"SA JHB Spring 2026 Final\",\n \"account_id\": 353,\n \"company_id\": 55,\n \"created_date\": \"2026-02-08\",\n \"user_id\": 103,\n \"token\": {\n \"token\": \"792f5de5d3bcb5e76e4e7ae89313abd168042d8dfaed8ce483f92c70a54199aab4af4f88669bbacfaa51f33cf4460af9caa\",\n \"created_at\": \"2026-02-08 20:10:32\"\n },\n \"data\": {\n \"goal\": \"{\\\"id\\\":2,\\\"name\\\":\\\"Branding / Brand Awareness\\\"}\",\n \"tags\": [\n {\n \"id\": \"001\",\n \"cpm\": 2.73,\n \"ots\": 169719,\n \"code\": \"001\",\n \"name\": \"JOHANNESBURG CBD\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 11654.98,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"JOHANNESBURG CBD\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198256\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.044678\",\n \"dimensions\": {\n \"hight\": 59,\n \"width\": 20\n },\n \"orientation\": \"NE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 5091570,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"002\",\n \"cpm\": 2.74,\n \"ots\": 212579,\n \"code\": \"002\",\n \"name\": \"GHANDI SQUARE\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 14658.95,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"GHANDI SQUARE\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.206317\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042741\",\n \"dimensions\": {\n \"hight\": 9,\n \"width\": 27\n },\n \"orientation\": \"S\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 6377370,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"003\",\n \"cpm\": 2.77,\n \"ots\": 35041,\n \"code\": \"003\",\n \"name\": \"Joburg CBD Park Station - Turn\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 2449.97,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Joburg CBD Park Station - Turn\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.197751\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042299\",\n \"dimensions\": {\n \"hight\": 2.5,\n \"width\": 6\n },\n \"orientation\": \"SW\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 1051230,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"004\",\n \"cpm\": 32.9,\n \"ots\": 31574,\n \"code\": \"004\",\n \"name\": \"PRK-074 JHB CBD Park Station - Wanders\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 26180.61,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"CBD Park Station - Wanders\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198408\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.043806\",\n \"dimensions\": {\n \"hight\": 2,\n \"width\": 5.5\n },\n \"orientation\": \"NE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 947220,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"005\",\n \"cpm\": 16.75,\n \"ots\": 22430,\n \"code\": \"005\",\n \"name\": \"NM/MAP/INTHBP - Hanging Banners Package\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 9015.43,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"MAPONYA MALL SOWETOe\",\n \"city_id\": 2634183,\n \"latitude\": \"-26.258943\",\n \"city_code\": 2634183,\n \"city_name\": \"Soweto\",\n \"longitude\": \"27.901993\",\n \"dimensions\": {\n \"hight\": 2,\n \"width\": 6\n },\n \"orientation\": \"SE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 672900,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"006\",\n \"cpm\": 4.36,\n \"ots\": 251621,\n \"code\": \"006\",\n \"name\": \"Billboard\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 26336.42,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Soweto iconic\",\n \"city_id\": 2634183,\n \"latitude\": \"-26.237273\",\n \"city_code\": 2634183,\n \"city_name\": \"Soweto\",\n \"longitude\": \"27.901514\",\n \"dimensions\": {\n \"hight\": 8,\n \"width\": 37\n },\n \"orientation\": \"N\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 7548630,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"007\",\n \"cpm\": 0.96,\n \"ots\": 258816,\n \"code\": \"007\",\n \"name\": \"Park Station Entrance\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 6246.91,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Park Station Entrance\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.195686\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.041821\",\n \"dimensions\": {\n \"hight\": 14,\n \"width\": 16\n },\n \"orientation\": \"N\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 7764480,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"008\",\n \"cpm\": 4.92,\n \"ots\": 51494,\n \"code\": \"008\",\n \"name\": \"Park Station Western Concourse 2\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 6388.89,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Park Station Western Concourse 2\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198028\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042444\",\n \"dimensions\": {\n \"hight\": 3,\n \"width\": 12\n },\n \"orientation\": \"W\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"no\",\n \"ots_total_plan\": 1544820,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n }\n ],\n \"title\": \"SA JHB Spring 2026 Final\",\n \"weeks\": 4,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"gender\": \"3\",\n \"end_date\": \"2025-03-31 00:00:00\",\n \"geo_type\": {\n \"id\": 1,\n \"name\": \"city\"\n },\n \"age_range\": {\n \"max_age\": \"55\",\n \"min_age\": \"18\"\n },\n \"behaviors\": [],\n \"countries\": [\n {\n \"name\": \"South Africa\",\n \"cities\": [\n {\n \"id\": 2627446,\n \"name\": \"Johannesburg\",\n \"assets\": 6,\n \"budget\": {\n \"amount\": 67580.31,\n \"iso_currency_code\": \"USD\"\n },\n \"city_id\": 2627446,\n \"coverage\": 81.06,\n \"city_name\": \"Johannesburg\",\n \"region_id\": 4054,\n \"region_name\": \"Gauteng\",\n \"audience_cpm\": 4.06,\n \"audience_ots\": 16626984,\n \"total_population\": 1550000,\n \"average_frequency\": 21.15,\n \"reached_population\": 916789,\n \"audience_population\": 1131000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 81.06\n },\n {\n \"name\": \"+2\",\n \"value\": 79.2\n },\n {\n \"name\": \"+3\",\n \"value\": 77.4\n },\n {\n \"name\": \"+4\",\n \"value\": 75.7\n },\n {\n \"name\": \"+5\",\n \"value\": 73.9\n },\n {\n \"name\": \"+6\",\n \"value\": 72.2\n },\n {\n \"name\": \"+7\",\n \"value\": 70.6\n },\n {\n \"name\": \"+8\",\n \"value\": 69\n },\n {\n \"name\": \"+9\",\n \"value\": 67.4\n },\n {\n \"name\": \"+10\",\n \"value\": 65.9\n },\n {\n \"name\": \"+11\",\n \"value\": 64.4\n },\n {\n \"name\": \"+12\",\n \"value\": 62.9\n },\n {\n \"name\": \"+13\",\n \"value\": 61.5\n },\n {\n \"name\": \"+14\",\n \"value\": 60.1\n },\n {\n \"name\": \"+15\",\n \"value\": 58.7\n },\n {\n \"name\": \"+16\",\n \"value\": 57.4\n },\n {\n \"name\": \"+17\",\n \"value\": 56.1\n },\n {\n \"name\": \"+18\",\n \"value\": 54.8\n },\n {\n \"name\": \"+19\",\n \"value\": 53.6\n },\n {\n \"name\": \"+20\",\n \"value\": 52.4\n },\n {\n \"name\": \"+21\",\n \"value\": 51.2\n },\n {\n \"name\": \"+22\",\n \"value\": 50\n }\n ]\n },\n {\n \"id\": 2634183,\n \"name\": \"Soweto\",\n \"assets\": 2,\n \"budget\": {\n \"amount\": 35351.85,\n \"iso_currency_code\": \"USD\"\n },\n \"city_id\": 2634183,\n \"coverage\": 54.17,\n \"city_name\": \"Soweto\",\n \"region_id\": 4054,\n \"region_name\": \"Gauteng\",\n \"audience_cpm\": 6.42,\n \"audience_ots\": 5508425,\n \"total_population\": 1500000,\n \"average_frequency\": 11.8,\n \"reached_population\": 542783,\n \"audience_population\": 1002000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 54.17\n },\n {\n \"name\": \"+2\",\n \"value\": 52.5\n },\n {\n \"name\": \"+3\",\n \"value\": 50.8\n },\n {\n \"name\": \"+4\",\n \"value\": 49.2\n },\n {\n \"name\": \"+5\",\n \"value\": 47.7\n },\n {\n \"name\": \"+6\",\n \"value\": 46.2\n },\n {\n \"name\": \"+7\",\n \"value\": 44.8\n },\n {\n \"name\": \"+8\",\n \"value\": 43.4\n },\n {\n \"name\": \"+9\",\n \"value\": 42\n },\n {\n \"name\": \"+10\",\n \"value\": 40.7\n },\n {\n \"name\": \"+11\",\n \"value\": 39.4\n },\n {\n \"name\": \"+12\",\n \"value\": 38.2\n },\n {\n \"name\": \"+13\",\n \"value\": 37\n },\n {\n \"name\": \"+14\",\n \"value\": 35.8\n },\n {\n \"name\": \"+15\",\n \"value\": 34.7\n },\n {\n \"name\": \"+16\",\n \"value\": 33.6\n },\n {\n \"name\": \"+17\",\n \"value\": 32.6\n },\n {\n \"name\": \"+18\",\n \"value\": 31.6\n },\n {\n \"name\": \"+19\",\n \"value\": 30.6\n },\n {\n \"name\": \"+20\",\n \"value\": 29.6\n },\n {\n \"name\": \"+21\",\n \"value\": 28.7\n },\n {\n \"name\": \"+22\",\n \"value\": 27.8\n }\n ]\n }\n ],\n \"iso_code\": \"ZA\",\n \"all_locations\": {\n \"TRP\": 1209.3261486169715,\n \"assets\": 8,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"coverage\": 68.42812939521801,\n \"audience_cpm\": 4.6501133094039515,\n \"audience_ots\": 22135409,\n \"total_population\": 3050000,\n \"average_frequency\": 17.67293888208324,\n \"reached_population\": 1459572,\n \"audience_population\": 2133000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 68.42812939521801\n },\n {\n \"name\": \"+2\",\n \"value\": 66.65738396624472\n },\n {\n \"name\": \"+3\",\n \"value\": 64.9043600562588\n },\n {\n \"name\": \"+4\",\n \"value\": 63.251336146272855\n },\n {\n \"name\": \"+5\",\n \"value\": 61.59226441631505\n },\n {\n \"name\": \"+6\",\n \"value\": 59.986216596343176\n },\n {\n \"name\": \"+7\",\n \"value\": 58.48016877637131\n },\n {\n \"name\": \"+8\",\n \"value\": 56.97412095639944\n },\n {\n \"name\": \"+9\",\n \"value\": 55.46807313642757\n },\n {\n \"name\": \"+10\",\n \"value\": 54.062025316455696\n },\n {\n \"name\": \"+11\",\n \"value\": 52.65597749648383\n },\n {\n \"name\": \"+12\",\n \"value\": 51.29690576652602\n },\n {\n \"name\": \"+13\",\n \"value\": 49.99085794655415\n },\n {\n \"name\": \"+14\",\n \"value\": 48.68481012658228\n },\n {\n \"name\": \"+15\",\n \"value\": 47.425738396624475\n },\n {\n \"name\": \"+16\",\n \"value\": 46.2196905766526\n },\n {\n \"name\": \"+17\",\n \"value\": 45.060618846694794\n },\n {\n \"name\": \"+18\",\n \"value\": 43.90154711673699\n },\n {\n \"name\": \"+19\",\n \"value\": 42.79549929676512\n },\n {\n \"name\": \"+20\",\n \"value\": 41.68945147679325\n },\n {\n \"name\": \"+21\",\n \"value\": 40.630379746835445\n },\n {\n \"name\": \"+22\",\n \"value\": 39.57130801687764\n }\n ]\n }\n }\n ],\n \"interests\": [],\n \"languages\": [],\n \"advertiser\": \"{\\\"advertiser\\\":{\\\"id\\\":353,\\\"name\\\":\\\"inDrive\\\"},\\\"brand\\\":{\\\"id\\\":317,\\\"name\\\":\\\"inDrive\\\"}}\",\n \"start_date\": \"2025-03-01 00:00:00\",\n \"socioeconomic_levels\": \"{\\\"min\\\":{\\\"id\\\":3,\\\"name\\\":\\\"medium\\\"},\\\"max\\\":{\\\"id\\\":7,\\\"name\\\":\\\"low_low\\\"}}\"\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": {\n \"id\": 353,\n \"type\": \"accounts\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/792\"\n }\n },\n \"company\": {\n \"data\": {\n \"id\": 55,\n \"type\": \"companies\",\n \"name\": \"inDrive\",\n \"logo\": \"https://metrics-tdtglobal.s3.amazonaws.com/images/companies/system-company-55-681280c993ce5.jpg\",\n \"profile\": {\n \"id\": 2,\n \"name\": \"Premium\"\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/companies/792\"\n }\n },\n \"user\": {\n \"data\": {\n \"id\": 103,\n \"type\": \"users\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/users/792\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/media-plan/792\"\n }\n }\n}"},{"id":"c37178f7-f1b4-416f-a526-3188b9cc996c","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{api_url}}/media-plan/:id?lang=pt&company_id=55","host":["{{api_url}}"],"path":["media-plan",":id"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"token","value":"352ca7efadf394b4c96506db589dde84f4e4f21782ef943d4aae1d66333807b78b7c18ec13fba22e4ceb50d01c73efce941","description":"optional | string","disabled":true}],"variable":[{"key":"id","value":"792"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 16:05:05 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"99831b0e-72d5-4d94-b645-3d1f22080d5c"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthenticated.\"\n}"},{"id":"aab1ce48-4166-4781-8500-8993bc76eff0","name":"404 Not Found — Resource Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{api_url}}/media-plan/:id?lang=pt&company_id=55","host":["{{api_url}}"],"path":["media-plan",":id"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"token","value":"352ca7efadf394b4c96506db589dde84f4e4f21782ef943d4aae1d66333807b78b7c18ec13fba22e4ceb50d01c73efce941","description":"optional | string","disabled":true}],"variable":[{"key":"id","value":"790"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 15:47:52 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"9007fc27-3bee-4871-af70-aa20efb84859"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Media Plan not found.\"\n}"},{"id":"2e34fe7e-19bc-4783-8f1c-df097b555157","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{api_url}}/media-plan/:id?lang=pt&company_id=55","host":["{{api_url}}"],"path":["media-plan",":id"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"token","value":"352ca7efadf394b4c96506db589dde84f4e4f21782ef943d4aae1d66333807b78b7c18ec13fba22e4ceb50d01c73efce941","description":"optional | string","disabled":true}],"variable":[{"key":"id","value":"792"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 15:52:22 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"690e77e1-d925-41d6-a929-78123f510043"},{"name":"Get media plan paginated","id":"61421510-13ed-400e-8c12-203232c77fd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{api_url}}/media-plans/paginated?lang=en&company_id=55&include[]=company&include[]=user&include[]=account&page[number]=1&page[size]=1","description":"Retrieves a paginated list of Media Plan evaluations. Use this endpoint to build history views, dashboards, or to browse/filter previously executed Media Plans.
\nThis endpoint requires a valid Bearer token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: /api/media-plan
Headers:
\nAccept: application/json
Authorization: Bearer {{token}}
\n\nNote: The available filter/sort parameters may vary by implementation. If your API exposes different query params (e.g.,
\nlimit,offset,q), reflect them here to match your collection.
Returned when the request is valid and the authenticated user has access to the requested company scope.
\n\n\nSample data only. IDs, names, emails, URLs, and tokens are generic.
\n
{\n \"data\": [\n {\n \"id\": 792,\n \"type\": \"evaluation\",\n \"attributes\": {\n \"name\": \"Sample Media Plan Name\",\n \"account_id\": 353,\n \"company_id\": 55,\n \"created_date\": \"2026-02-08\",\n \"user_id\": 103,\n \"token\": {\n \"token\": \"792f5de5d3bcb5e76e4e7ae89313abd168042d8d...<truncated>\",\n \"created_at\": \"2026-02-08 20:10:32\"\n },\n \"data\": {\n \"goal\": \"{\\\"id\\\":2,\\\"name\\\":\\\"Brand Awareness\\\"}\",\n \"title\": \"Sample Media Plan Title\",\n \"weeks\": 4,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"start_date\": \"2025-03-01 00:00:00\",\n \"end_date\": \"2025-03-31 00:00:00\",\n \"gender\": \"3\",\n \"geo_type\": {\n \"id\": 1,\n \"name\": \"city\"\n },\n \"age_range\": {\n \"min_age\": \"18\",\n \"max_age\": \"55\"\n },\n \"behaviors\": [],\n \"interests\": [],\n \"languages\": [],\n \"advertiser\": \"{\\\"advertiser\\\":{\\\"id\\\":353,\\\"name\\\":\\\"Sample Advertiser\\\"},\\\"brand\\\":{\\\"id\\\":317,\\\"name\\\":\\\"Sample Brand\\\"}}\",\n \"socioeconomic_levels\": \"{\\\"min\\\":{\\\"id\\\":3,\\\"name\\\":\\\"medium\\\"},\\\"max\\\":{\\\"id\\\":7,\\\"name\\\":\\\"low_low\\\"}}\",\n \"tags\": [\n {\n \"id\": \"001\",\n \"code\": \"001\",\n \"name\": \"Sample Location 001\",\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"city_id\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"region\": \"Gauteng\",\n \"budget\": {\n \"amount\": 11654.98,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"start_date\": \"2025-03-01 00:00:00\",\n \"end_date\": \"2025-03-31 00:00:00\"\n },\n \"ots\": 169719,\n \"cpm\": 2.73,\n \"illumination\": \"yes\",\n \"dimensions\": {\n \"hight\": 59,\n \"width\": 20\n },\n \"classifications\": {\n \"size\": { \"id\": 1, \"name\": \"large\" },\n \"material\": { \"id\": 1, \"name\": \"printed\" },\n \"placeType\": { \"id\": 8, \"name\": \"Urban + Suburban\" },\n \"mediaClass\": { \"id\": 2, \"name\": \"roadside\" },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n }\n ],\n \"countries\": [\n {\n \"name\": \"South Africa\",\n \"iso_code\": \"ZA\",\n \"cities\": [\n {\n \"id\": 2627446,\n \"name\": \"Johannesburg\",\n \"assets\": 6,\n \"coverage\": 81.06,\n \"audience_cpm\": 4.06,\n \"audience_ots\": 16626984,\n \"total_population\": 1550000,\n \"reached_population\": 916789,\n \"audience_population\": 1131000,\n \"average_frequency\": 21.15,\n \"budget\": {\n \"amount\": 67580.31,\n \"iso_currency_code\": \"USD\"\n },\n \"effective_frequency\": [\n { \"name\": \"+1\", \"value\": 81.06 },\n { \"name\": \"+2\", \"value\": 79.2 }\n ]\n }\n ],\n \"all_locations\": {\n \"TRP\": 1209.3261486169715,\n \"assets\": 8,\n \"coverage\": 68.42812939521801,\n \"audience_cpm\": 4.6501133094039515,\n \"audience_ots\": 22135409,\n \"total_population\": 3050000,\n \"reached_population\": 1459572,\n \"audience_population\": 2133000,\n \"average_frequency\": 17.67293888208324,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"effective_frequency\": [\n { \"name\": \"+1\", \"value\": 68.42812939521801 },\n { \"name\": \"+2\", \"value\": 66.65738396624472 }\n ]\n }\n }\n ]\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": { \"id\": 353, \"type\": \"accounts\" },\n \"links\": { \"self\": \"https://api.example.com/api/accounts/353\" }\n },\n \"company\": {\n \"data\": {\n \"id\": 55,\n \"type\": \"companies\",\n \"name\": \"Sample Company\",\n \"logo\": \"https://cdn.example.com/images/companies/company-55.jpg\",\n \"profile\": { \"id\": 2, \"name\": \"Premium\" }\n },\n \"links\": { \"self\": \"https://api.example.com/api/companies/55\" }\n },\n \"user\": {\n \"data\": { \"id\": 103, \"type\": \"users\" },\n \"links\": { \"self\": \"https://api.example.com/api/users/103\" }\n }\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/media-plan/792\"\n }\n }\n ],\n \"links\": {\n \"first\": \"https://api.example.com/api/media-plan/paginated?page=1\",\n \"last\": \"https://api.example.com/api/media-plan/paginated?page=91\",\n \"prev\": null,\n \"next\": \"https://api.example.com/api/media-plan/paginated?page=2\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 91,\n \"per_page\": 1,\n \"total_pages\": 91\n },\n \"included\": [\n {\n \"id\": 55,\n \"type\": \"companies\",\n \"attributes\": {\n \"name\": \"Sample Company\",\n \"country_id\": 4,\n \"address\": \"\",\n \"tax_identification\": null,\n \"phone_number\": null,\n \"timezone\": null,\n \"updated_at\": \"2025-04-30T19:58:01.000000Z\",\n \"logo\": \"https://cdn.example.com/images/companies/company-55.jpg\",\n \"profile\": { \"id\": 2, \"name\": \"Premium\" }\n },\n \"relationships\": {\n \"country\": {\n \"links\": { \"self\": \"https://api.example.com/api/countries/4\" }\n },\n \"logo\": {\n \"data\": { \"id\": 21277, \"type\": \"images\" }\n }\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/companies/55\"\n }\n },\n {\n \"id\": 103,\n \"type\": \"users\",\n \"attributes\": {\n \"name\": \"Sample\",\n \"last_name\": \"User\",\n \"avatar\": null,\n \"email\": \"user@example.com\",\n \"country_id\": 4,\n \"company_id\": 55,\n \"user_type_id\": 1,\n \"timezone\": null,\n \"position\": \"Admin\",\n \"phone_number\": null,\n \"birthday\": null,\n \"gender\": null,\n \"first_loggin_at\": \"2026-02-09 16:20:19\"\n },\n \"relationships\": {\n \"country\": [],\n \"company\": [],\n \"user_type\": [],\n \"permissions\": [],\n \"roles\": []\n },\n \"links\": {\n \"self\": \"https://api.example.com/api/users/103\"\n }\n }\n ]\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Token expired\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\n{\n \"message\": \"The route api/media-plans/paginated could not be found.\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/media-plan?company_id=55&page=1&per_page=10' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string [en, es, pt]
\n","type":"text/plain"},"key":"lang","value":"en"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[name]","value":"Plan de prueba Daniel"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[id][]","value":"1"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[account][]","value":"66"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[user][]","value":""},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[company][]","value":""},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"include[]","value":"company"},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"include[]","value":"user"},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"include[]","value":"account"},{"disabled":true,"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"name"},{"disabled":true,"key":"sort[]","value":"-createdAt"},{"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[number]","value":"1"},{"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[size]","value":"1"}],"variable":[]}},"response":[{"id":"0856ff31-5a56-4c29-9c53-9f8d7ae23dd4","name":"200 OK — Get media plan paginated","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/media-plan/paginated?lang=en&company_id=55&include[]=company&include[]=user&include[]=account&page[number]=1&page[size]=1","host":["{{api_url}}"],"path":["media-plan","paginated"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"Plan de prueba Daniel","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[account][]","value":"66","description":"optional | array | integer","disabled":true},{"key":"filter[user][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"filter[company][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"include[]","value":"company","description":"optional | array | string"},{"key":"include[]","value":"user","description":"optional | array | string"},{"key":"include[]","value":"account","description":"optional | array | string"},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer"},{"key":"page[size]","value":"1","description":"optional | integer"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 16:20:12 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"1c6378a7-a06d-43e6-bbc1-e3f707f4be9b"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 792,\n \"type\": \"evaluation\",\n \"attributes\": {\n \"name\": \"SA JHB Spring 2026 Final\",\n \"account_id\": 353,\n \"company_id\": 55,\n \"created_date\": \"2026-02-08\",\n \"user_id\": 103,\n \"token\": {\n \"token\": \"792f5de5d3bcb5e76e4e7ae89313abd168042d8dfaed8ce483f92c70a54199aab4af4f88669bbacfaa51f33cf4460af9caa\",\n \"created_at\": \"2026-02-08 20:10:32\"\n },\n \"data\": {\n \"goal\": \"{\\\"id\\\":2,\\\"name\\\":\\\"Branding / Brand Awareness\\\"}\",\n \"tags\": [\n {\n \"id\": \"001\",\n \"cpm\": 2.73,\n \"ots\": 169719,\n \"code\": \"001\",\n \"name\": \"JOHANNESBURG CBD\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 11654.98,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"JOHANNESBURG CBD\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198256\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.044678\",\n \"dimensions\": {\n \"hight\": 59,\n \"width\": 20\n },\n \"orientation\": \"NE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 5091570,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"002\",\n \"cpm\": 2.74,\n \"ots\": 212579,\n \"code\": \"002\",\n \"name\": \"GHANDI SQUARE\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 14658.95,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"GHANDI SQUARE\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.206317\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042741\",\n \"dimensions\": {\n \"hight\": 9,\n \"width\": 27\n },\n \"orientation\": \"S\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 6377370,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"003\",\n \"cpm\": 2.77,\n \"ots\": 35041,\n \"code\": \"003\",\n \"name\": \"Joburg CBD Park Station - Turn\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 2449.97,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Joburg CBD Park Station - Turn\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.197751\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042299\",\n \"dimensions\": {\n \"hight\": 2.5,\n \"width\": 6\n },\n \"orientation\": \"SW\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 1051230,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"004\",\n \"cpm\": 32.9,\n \"ots\": 31574,\n \"code\": \"004\",\n \"name\": \"PRK-074 JHB CBD Park Station - Wanders\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 26180.61,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"CBD Park Station - Wanders\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198408\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.043806\",\n \"dimensions\": {\n \"hight\": 2,\n \"width\": 5.5\n },\n \"orientation\": \"NE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 947220,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"005\",\n \"cpm\": 16.75,\n \"ots\": 22430,\n \"code\": \"005\",\n \"name\": \"NM/MAP/INTHBP - Hanging Banners Package\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 9015.43,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"MAPONYA MALL SOWETOe\",\n \"city_id\": 2634183,\n \"latitude\": \"-26.258943\",\n \"city_code\": 2634183,\n \"city_name\": \"Soweto\",\n \"longitude\": \"27.901993\",\n \"dimensions\": {\n \"hight\": 2,\n \"width\": 6\n },\n \"orientation\": \"SE\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 672900,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"006\",\n \"cpm\": 4.36,\n \"ots\": 251621,\n \"code\": \"006\",\n \"name\": \"Billboard\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 26336.42,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Soweto iconic\",\n \"city_id\": 2634183,\n \"latitude\": \"-26.237273\",\n \"city_code\": 2634183,\n \"city_name\": \"Soweto\",\n \"longitude\": \"27.901514\",\n \"dimensions\": {\n \"hight\": 8,\n \"width\": 37\n },\n \"orientation\": \"N\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 7548630,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 2,\n \"name\": \"roadside\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"007\",\n \"cpm\": 0.96,\n \"ots\": 258816,\n \"code\": \"007\",\n \"name\": \"Park Station Entrance\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 6246.91,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Park Station Entrance\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.195686\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.041821\",\n \"dimensions\": {\n \"hight\": 14,\n \"width\": 16\n },\n \"orientation\": \"N\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"yes\",\n \"ots_total_plan\": 7764480,\n \"classifications\": {\n \"size\": {\n \"id\": 1,\n \"name\": \"large\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n },\n {\n \"id\": \"008\",\n \"cpm\": 4.92,\n \"ots\": 51494,\n \"code\": \"008\",\n \"name\": \"Park Station Western Concourse 2\",\n \"unit\": \"m\",\n \"budget\": {\n \"amount\": 6388.89,\n \"iso_currency_code\": \"USD\"\n },\n \"period\": {\n \"end_date\": \"2025-03-31 00:00:00\",\n \"start_date\": \"2025-03-01 00:00:00\"\n },\n \"region\": \"Gauteng\",\n \"status\": 1,\n \"address\": \"Park Station Western Concourse 2\",\n \"city_id\": 2627446,\n \"latitude\": \"-26.198028\",\n \"city_code\": 2627446,\n \"city_name\": \"Johannesburg\",\n \"longitude\": \"28.042444\",\n \"dimensions\": {\n \"hight\": 3,\n \"width\": 12\n },\n \"orientation\": \"W\",\n \"region_code\": 4054,\n \"country_code\": \"ZA\",\n \"country_name\": \"South Africa\",\n \"illumination\": \"no\",\n \"ots_total_plan\": 1544820,\n \"classifications\": {\n \"size\": {\n \"id\": 2,\n \"name\": \"medium\"\n },\n \"material\": {\n \"id\": 1,\n \"name\": \"printed\"\n },\n \"placeType\": {\n \"id\": 8,\n \"name\": \"Urban + Suburban\"\n },\n \"mediaClass\": {\n \"id\": 3,\n \"name\": \"place based\"\n },\n \"id_classification\": 0,\n \"name_classification\": \"\"\n }\n }\n ],\n \"title\": \"SA JHB Spring 2026 Final\",\n \"weeks\": 4,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"gender\": \"3\",\n \"end_date\": \"2025-03-31 00:00:00\",\n \"geo_type\": {\n \"id\": 1,\n \"name\": \"city\"\n },\n \"age_range\": {\n \"max_age\": \"55\",\n \"min_age\": \"18\"\n },\n \"behaviors\": [],\n \"countries\": [\n {\n \"name\": \"South Africa\",\n \"cities\": [\n {\n \"id\": 2627446,\n \"name\": \"Johannesburg\",\n \"assets\": 6,\n \"budget\": {\n \"amount\": 67580.31,\n \"iso_currency_code\": \"USD\"\n },\n \"city_id\": 2627446,\n \"coverage\": 81.06,\n \"city_name\": \"Johannesburg\",\n \"region_id\": 4054,\n \"region_name\": \"Gauteng\",\n \"audience_cpm\": 4.06,\n \"audience_ots\": 16626984,\n \"total_population\": 1550000,\n \"average_frequency\": 21.15,\n \"reached_population\": 916789,\n \"audience_population\": 1131000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 81.06\n },\n {\n \"name\": \"+2\",\n \"value\": 79.2\n },\n {\n \"name\": \"+3\",\n \"value\": 77.4\n },\n {\n \"name\": \"+4\",\n \"value\": 75.7\n },\n {\n \"name\": \"+5\",\n \"value\": 73.9\n },\n {\n \"name\": \"+6\",\n \"value\": 72.2\n },\n {\n \"name\": \"+7\",\n \"value\": 70.6\n },\n {\n \"name\": \"+8\",\n \"value\": 69\n },\n {\n \"name\": \"+9\",\n \"value\": 67.4\n },\n {\n \"name\": \"+10\",\n \"value\": 65.9\n },\n {\n \"name\": \"+11\",\n \"value\": 64.4\n },\n {\n \"name\": \"+12\",\n \"value\": 62.9\n },\n {\n \"name\": \"+13\",\n \"value\": 61.5\n },\n {\n \"name\": \"+14\",\n \"value\": 60.1\n },\n {\n \"name\": \"+15\",\n \"value\": 58.7\n },\n {\n \"name\": \"+16\",\n \"value\": 57.4\n },\n {\n \"name\": \"+17\",\n \"value\": 56.1\n },\n {\n \"name\": \"+18\",\n \"value\": 54.8\n },\n {\n \"name\": \"+19\",\n \"value\": 53.6\n },\n {\n \"name\": \"+20\",\n \"value\": 52.4\n },\n {\n \"name\": \"+21\",\n \"value\": 51.2\n },\n {\n \"name\": \"+22\",\n \"value\": 50\n }\n ]\n },\n {\n \"id\": 2634183,\n \"name\": \"Soweto\",\n \"assets\": 2,\n \"budget\": {\n \"amount\": 35351.85,\n \"iso_currency_code\": \"USD\"\n },\n \"city_id\": 2634183,\n \"coverage\": 54.17,\n \"city_name\": \"Soweto\",\n \"region_id\": 4054,\n \"region_name\": \"Gauteng\",\n \"audience_cpm\": 6.42,\n \"audience_ots\": 5508425,\n \"total_population\": 1500000,\n \"average_frequency\": 11.8,\n \"reached_population\": 542783,\n \"audience_population\": 1002000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 54.17\n },\n {\n \"name\": \"+2\",\n \"value\": 52.5\n },\n {\n \"name\": \"+3\",\n \"value\": 50.8\n },\n {\n \"name\": \"+4\",\n \"value\": 49.2\n },\n {\n \"name\": \"+5\",\n \"value\": 47.7\n },\n {\n \"name\": \"+6\",\n \"value\": 46.2\n },\n {\n \"name\": \"+7\",\n \"value\": 44.8\n },\n {\n \"name\": \"+8\",\n \"value\": 43.4\n },\n {\n \"name\": \"+9\",\n \"value\": 42\n },\n {\n \"name\": \"+10\",\n \"value\": 40.7\n },\n {\n \"name\": \"+11\",\n \"value\": 39.4\n },\n {\n \"name\": \"+12\",\n \"value\": 38.2\n },\n {\n \"name\": \"+13\",\n \"value\": 37\n },\n {\n \"name\": \"+14\",\n \"value\": 35.8\n },\n {\n \"name\": \"+15\",\n \"value\": 34.7\n },\n {\n \"name\": \"+16\",\n \"value\": 33.6\n },\n {\n \"name\": \"+17\",\n \"value\": 32.6\n },\n {\n \"name\": \"+18\",\n \"value\": 31.6\n },\n {\n \"name\": \"+19\",\n \"value\": 30.6\n },\n {\n \"name\": \"+20\",\n \"value\": 29.6\n },\n {\n \"name\": \"+21\",\n \"value\": 28.7\n },\n {\n \"name\": \"+22\",\n \"value\": 27.8\n }\n ]\n }\n ],\n \"iso_code\": \"ZA\",\n \"all_locations\": {\n \"TRP\": 1209.3261486169715,\n \"assets\": 8,\n \"budget\": {\n \"amount\": 102932.16,\n \"iso_currency_code\": \"USD\"\n },\n \"coverage\": 68.42812939521801,\n \"audience_cpm\": 4.6501133094039515,\n \"audience_ots\": 22135409,\n \"total_population\": 3050000,\n \"average_frequency\": 17.67293888208324,\n \"reached_population\": 1459572,\n \"audience_population\": 2133000,\n \"effective_frequency\": [\n {\n \"name\": \"+1\",\n \"value\": 68.42812939521801\n },\n {\n \"name\": \"+2\",\n \"value\": 66.65738396624472\n },\n {\n \"name\": \"+3\",\n \"value\": 64.9043600562588\n },\n {\n \"name\": \"+4\",\n \"value\": 63.251336146272855\n },\n {\n \"name\": \"+5\",\n \"value\": 61.59226441631505\n },\n {\n \"name\": \"+6\",\n \"value\": 59.986216596343176\n },\n {\n \"name\": \"+7\",\n \"value\": 58.48016877637131\n },\n {\n \"name\": \"+8\",\n \"value\": 56.97412095639944\n },\n {\n \"name\": \"+9\",\n \"value\": 55.46807313642757\n },\n {\n \"name\": \"+10\",\n \"value\": 54.062025316455696\n },\n {\n \"name\": \"+11\",\n \"value\": 52.65597749648383\n },\n {\n \"name\": \"+12\",\n \"value\": 51.29690576652602\n },\n {\n \"name\": \"+13\",\n \"value\": 49.99085794655415\n },\n {\n \"name\": \"+14\",\n \"value\": 48.68481012658228\n },\n {\n \"name\": \"+15\",\n \"value\": 47.425738396624475\n },\n {\n \"name\": \"+16\",\n \"value\": 46.2196905766526\n },\n {\n \"name\": \"+17\",\n \"value\": 45.060618846694794\n },\n {\n \"name\": \"+18\",\n \"value\": 43.90154711673699\n },\n {\n \"name\": \"+19\",\n \"value\": 42.79549929676512\n },\n {\n \"name\": \"+20\",\n \"value\": 41.68945147679325\n },\n {\n \"name\": \"+21\",\n \"value\": 40.630379746835445\n },\n {\n \"name\": \"+22\",\n \"value\": 39.57130801687764\n }\n ]\n }\n }\n ],\n \"interests\": [],\n \"languages\": [],\n \"advertiser\": \"{\\\"advertiser\\\":{\\\"id\\\":353,\\\"name\\\":\\\"inDrive\\\"},\\\"brand\\\":{\\\"id\\\":317,\\\"name\\\":\\\"inDrive\\\"}}\",\n \"start_date\": \"2025-03-01 00:00:00\",\n \"socioeconomic_levels\": \"{\\\"min\\\":{\\\"id\\\":3,\\\"name\\\":\\\"medium\\\"},\\\"max\\\":{\\\"id\\\":7,\\\"name\\\":\\\"low_low\\\"}}\"\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": {\n \"id\": 353,\n \"type\": \"accounts\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/792\"\n }\n },\n \"company\": {\n \"data\": {\n \"id\": 55,\n \"type\": \"companies\",\n \"name\": \"inDrive\",\n \"logo\": \"https://metrics-tdtglobal.s3.amazonaws.com/images/companies/system-company-55-681280c993ce5.jpg\",\n \"profile\": {\n \"id\": 2,\n \"name\": \"Premium\"\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/companies/792\"\n }\n },\n \"user\": {\n \"data\": {\n \"id\": 103,\n \"type\": \"users\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/users/792\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/media-plan/792\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://localhost/api-evaluator/public/api/media-plan/paginated?page=1\",\n \"last\": \"http://localhost/api-evaluator/public/api/media-plan/paginated?page=91\",\n \"prev\": null,\n \"next\": \"http://localhost/api-evaluator/public/api/media-plan/paginated?page=2\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 91,\n \"per_page\": 1,\n \"total_pages\": 91\n },\n \"included\": [\n {\n \"id\": 55,\n \"type\": \"companies\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"country_id\": 4,\n \"address\": \"\",\n \"tax_identification\": null,\n \"phone_number\": null,\n \"timezone\": null,\n \"updated_at\": \"2025-04-30T19:58:01.000000Z\",\n \"logo\": \"https://metrics-tdtglobal.s3.amazonaws.com/images/companies/system-company-55-681280c993ce5.jpg\",\n \"profile\": {\n \"id\": 2,\n \"name\": \"Premium\"\n }\n },\n \"relationships\": {\n \"country\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/countries/4\"\n }\n },\n \"logo\": {\n \"data\": {\n \"id\": 21277,\n \"type\": \"images\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/companies/55\"\n }\n },\n {\n \"id\": 103,\n \"type\": \"users\",\n \"attributes\": {\n \"name\": \"Anar\",\n \"last_name\": \"Yussupova\",\n \"avatar\": null,\n \"email\": \"anar.yussupova@indriver.com\",\n \"country_id\": 4,\n \"company_id\": 55,\n \"user_type_id\": 1,\n \"timezone\": null,\n \"position\": \"Admin\",\n \"phone_number\": null,\n \"birthday\": null,\n \"gender\": null,\n \"first_loggin_at\": \"2026-02-09 16:20:19\"\n },\n \"relationships\": {\n \"country\": [],\n \"company\": [],\n \"user_type\": [],\n \"permissions\": [],\n \"roles\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/users/103\"\n }\n }\n ]\n}"},{"id":"139ea306-69e6-4018-8d64-dff78b52c04a","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/media-plan/paginated?lang=en&company_id=55&include[]=company&include[]=user&include[]=account&page[number]=1&page[size]=1","host":["{{api_url}}"],"path":["media-plan","paginated"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"Plan de prueba Daniel","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[account][]","value":"66","description":"optional | array | integer","disabled":true},{"key":"filter[user][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"filter[company][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"include[]","value":"company","description":"optional | array | string"},{"key":"include[]","value":"user","description":"optional | array | string"},{"key":"include[]","value":"account","description":"optional | array | string"},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer"},{"key":"page[size]","value":"1","description":"optional | integer"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 16:39:29 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Token expired\"\n}"},{"id":"ea0b5415-6a8e-4375-87df-881cad566e81","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/media-plans/paginated?lang=en&company_id=55&include[]=company&include[]=user&include[]=account&page[number]=1&page[size]=1","host":["{{api_url}}"],"path":["media-plans","paginated"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"Plan de prueba Daniel","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[account][]","value":"66","description":"optional | array | integer","disabled":true},{"key":"filter[user][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"filter[company][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"include[]","value":"company","description":"optional | array | string"},{"key":"include[]","value":"user","description":"optional | array | string"},{"key":"include[]","value":"account","description":"optional | array | string"},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer"},{"key":"page[size]","value":"1","description":"optional | integer"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 16:29:16 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"The route api/media-plans/paginated could not be found.\"\n}"},{"id":"92bfec18-52b7-49a6-b5fa-38a8797b4fef","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/media-plan/paginated?lang=en&company_id=55&include[]=company&include[]=user&include[]=account&page[number]=1&page[size]=1","host":["{{api_url}}"],"path":["media-plan","paginated"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"Plan de prueba Daniel","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[account][]","value":"66","description":"optional | array | integer","disabled":true},{"key":"filter[user][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"filter[company][]","value":"","description":"optional | array | integer","type":"text","disabled":true},{"key":"include[]","value":"company","description":"optional | array | string"},{"key":"include[]","value":"user","description":"optional | array | string"},{"key":"include[]","value":"account","description":"optional | array | string"},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer"},{"key":"page[size]","value":"1","description":"optional | integer"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 16:33:58 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"61421510-13ed-400e-8c12-203232c77fd9"},{"name":"Execute media plan","id":"305e4458-4df0-45d4-b41b-e9e3ce8eaa65","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"lang","value":"es","type":"text","description":"optional | string | es,en,pt
\n"},{"key":"company_id","value":"55","description":"required | integer
\n","type":"text","disabled":true},{"key":"file","type":"file","description":"required | file
\n","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/danie/Downloads/TDT Global - Template media plan v1.5 - Public (1).xlsx"],"src":"/C:/Users/danie/Downloads/Media plan template v1.5.1 - Example TDT Media Tech.xlsx"},{"key":"parameter_id[]","value":"47","description":"optional | array | integer
\n","type":"text","disabled":true},{"key":"parameter_id[]","value":"50","description":"optional | array | integer
\n","type":"text","disabled":true},{"key":"parameter_id[]","value":"957","description":"optional | array | integer
\n","type":"text","disabled":true},{"key":"parameter_id[]","value":"44332","description":"optional | array | integer
\n","type":"text","disabled":true},{"key":"parameter_id[]","value":"50176","description":"optional| array | integer
\n","type":"text","disabled":true},{"key":"parameter_id[]","value":"50873","description":"optional| array | integer
\n","type":"text","disabled":true},{"key":"parameters[]","value":"{\"types\":{\"id\":7,\"name\":\"Interests\"},\"interests\":[{\"name\":\"Agricultura\",\"id\":6003840140052},{\"name\":\"Aviación\",\"id\":6002963523717}]}","description":"optional | array | json
\n","type":"text","uuid":"d139ac2f-369b-442e-9f88-444bb635d3b5"},{"key":"advertiser","value":"{\"advertiser\":{\"id\":319,\"name\":\"Gatorade QA\",\"logo\":\"https://metrics-tdtglobal.s3.amazonaws.com/images/accounts/system-account-319-678fa1e580b6a.jpg\"},\"brand\":{\"id\":275,\"name\":\"Gatorade QA\"}}","description":"required | json
\n","type":"text"},{"key":"title","value":"Plan prueba","description":"required | string
\n","type":"text"},{"key":"goal","value":"{\"id\":1,\"name\":\"Lanzamiento de producto\"}","description":"required | json
\n","type":"text"},{"key":"gender","value":"3","description":"required | integer[1=MALE,2= FEMALE,3=BOTH]
\n","type":"text"},{"key":"socioeconomic_levels","value":"{\"min\":{\"id\":1,\"name\":\"high\"},\"max\":{\"id\":2,\"name\":\"medium_high\"}}","description":"required | json
\n","type":"text"},{"key":"age_min","value":"18","description":"required | integer
\n","type":"text"},{"key":"age_max","value":"65","description":"required | integer
\n","type":"text"},{"key":"geo_type","value":"3","description":"required | integer [1=City,3=Regions]
\n","type":"text","uuid":"cdf07d52-c5d8-4d2f-9c47-c905cbf34594"}]},"url":"{{api_url}}/media-plan","description":"Executes a Media Plan evaluation based on the input campaign configuration and returns a newly created evaluation record (including results and a generated token, depending on the company profile and execution mode).
\nUse this endpoint to run a Media Plan (single or multi-market) and obtain the evaluation output that can later be retrieved by ID.
\nThis endpoint requires a valid Bearer token.
\nAuthorization: Bearer {{token}}Method: POST
Endpoint: /api/media-plan
Content-Type: multipart/form-data (form-data)
Accept: application/json
Authorization: Bearer {{token}}
\n\nSent as query string (e.g.,
\n?company_id=55&lang=en) when applicable.
\n\nImportant: This endpoint uses multipart/form-data (not raw JSON).
\n
Complex values are sent as JSON strings in form-data fields.
Returned when the evaluation was executed successfully.
\nSample data only. IDs, names, emails, URLs, and tokens are generic.
\n{\n \"data\": {\n \"id_evaluation\": 805\n },\n \"message\": \"Your file was saved successfully. We are processing the information.\"\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\n{\n \"message\": \"The route api/media-plans could not be found.\"\n}\n\nReturned when required parameters are missing or invalid (body fields and/or company_id).
{\n \"message\": \"El campo file es obligatorio. (and 8 more errors)\",\n \"errors\": {\n \"file\": [\n \"El campo file es obligatorio.\"\n ],\n \"title\": [\n \"El campo title es obligatorio.\"\n ],\n \"advertiser\": [\n \"El campo advertiser es obligatorio.\"\n ],\n \"goal\": [\n \"El campo goal es obligatorio.\"\n ],\n \"socioeconomic_levels\": [\n \"El campo socioeconomic levels es obligatorio.\"\n ],\n \"gender\": [\n \"El campo gender es obligatorio.\"\n ],\n \"age_min\": [\n \"El campo age min es obligatorio.\"\n ],\n \"age_max\": [\n \"El campo age max es obligatorio.\"\n ],\n \"geo_type\": [\n \"El campo geo type es obligatorio.\"\n ]\n }\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/media-plan' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form 'lang=en' \\\n --form 'file=@\"/path/to/MediaPlanTemplate.xlsx\"' \\\n --form 'parameters[]={\"types\":{\"id\":7,\"name\":\"Interests\"},\"interests\":[{\"name\":\"Agriculture\",\"id\":6003840140052},{\"name\":\"Aviation\",\"id\":6002963523717}]}' \\\n --form 'advertiser={\"advertiser\":{\"id\":319,\"name\":\"Sample Advertiser\",\"logo\":\"https://cdn.example.com/images/accounts/account-319.jpg\"},\"brand\":{\"id\":275,\"name\":\"Sample Brand\"}}' \\\n --form 'title=Sample Media Plan Title' \\\n --form 'goal={\"id\":1,\"name\":\"Product Launch\"}' \\\n --form 'gender=3' \\\n --form 'socioeconomic_levels={\"min\":{\"id\":1,\"name\":\"high\"},\"max\":{\"id\":2,\"name\":\"medium_high\"}}' \\\n --form 'age_min=18' \\\n --form 'age_max=65' \\\n --form 'geo_type=3'\n\noptional | string | es,en,pt
\n"},{"key":"company_id","value":"55","description":"required | integer
\n","type":"text"},{"key":"file","type":"file","description":"required | integer
\n","src":"/C:/Users/danie/Downloads/Media plan template v1.5.1 - Example TDT Media Tech.xlsx"}]},"url":"{{api_url}}/media-plan-validate","description":"Validates a Media Plan Excel file before execution. This endpoint checks the uploaded file format and structure (template/version, required sheets/columns, and basic data rules) to ensure it can be processed successfully.
\nUse this endpoint to pre-validate the Excel input and prevent execution failures.
\nThis endpoint requires a valid Bearer token.
\nAuthorization: Bearer {{token}}Method: POST
Endpoint: /api/media-plan/validate-excel
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
Content-Type
\nmultipart/form-data\n\nTip: Use the official Media Plan Excel template version required by your API.
\n
Returned when the evaluation was executed successfully.
\n\n\n<p >Sample data only. IDs, names, emails, URLs, and tokens are generic.</p>
\n
{\n \"data\": {\n \"id_evaluation\": 805\n },\n \"message\": \"Your file was saved successfully. We are processing the information.\"\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the request is missing required fields or the uploaded file is not valid.
\n{\n \"message\": \"The file field is required.\",\n \"errors\": {\n \"file\": [\n \"The file field is required.\"\n ]\n }\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs while validating the file.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/media-plan/validate-excel' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form 'lang=en' \\\n --form 'file=@\"/path/to/MediaPlanTemplate.xlsx\"'\n\nMedia Plan is a feature that evaluates OOH (Out-Of-Home) media campaigns across one or multiple markets. It helps validate inputs, run the evaluation process, and retrieve results for reporting or further decision-making.
\nThis folder includes four endpoints that cover the complete workflow:
\nGET — Get media plan by id
Retrieves the full details and results of a single Media Plan execution using its unique identifier.
Use when: you already have a media_plan_id and need the complete output.
GET — Get media plan paginated
Returns a paginated list of Media Plans, usually for dashboards, history views, or filtering/searching.
Use when: you need browsing, filtering, or listing executions over time.
\nPOST — Execute media plan
Runs the Media Plan evaluation based on the provided inputs (campaign, market(s), dates, parameters, etc.). Produces a new execution/result that can be retrieved later.
Use when: you want to generate a new evaluation run.
\nPOST — Validate media plan excel
Validates the structure and required fields of an uploaded Excel file used as input for Media Plan execution. This is a pre-check to avoid failures during execution.
Use when: the client is submitting campaign inputs via Excel and you want to validate before executing.
\nBase URL: {{api_url}}
Default header: Accept: application/json
If the API is protected, include:
\nAuthorization: Bearer {{token}}These endpoints typically use:
\n200 success
\n401 unauthorized (missing/invalid token)
\n404 not found (resource not available)
\n422 validation error (missing/invalid fields)
\n500 unexpected server error
\nReturns the full catalog of available campaign objectives (goals) that can be used in Media Plan and other evaluation workflows.
\nUse when: you need to populate a dropdown/select in a client app or validate that a provided objective ID is supported.
\nThis endpoint requires a valid Bearer token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: /api/campaign-objectives
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
None.
\nReturned when the catalog is retrieved successfully.
\n\n\nSample values only.
\n
{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Product Launch\"\n },\n {\n \"id\": 2,\n \"name\": \"Branding / Brand Awareness\"\n }\n ]\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/campaign-objectives' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string [en, es, pt]
\n","type":"text/plain"},"key":"lang","value":"en"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"50"}],"variable":[]}},"response":[{"id":"bc7e1dbb-8a14-4cc2-9e16-0dd75b962525","name":"200 OK — Get all objectives","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/campaign-objective?lang=es&company_id=55","host":["{{api_url}}"],"path":["campaign-objective"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"tarea","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"order","description":"optional | array | string","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:29:09 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"270eb06e-f4db-4fb8-8805-310b9c7a4359"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1,\n \"type\": \"campaign_objectives\",\n \"attributes\": {\n \"name\": \"Lanzamiento de producto\"\n },\n \"relationships\": [],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/campaign-objective/1\"\n }\n },\n {\n \"id\": 2,\n \"type\": \"campaign_objectives\",\n \"attributes\": {\n \"name\": \"Branding / Conciencia de Marca\"\n },\n \"relationships\": [],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/campaign-objective/2\"\n }\n },\n {\n \"id\": 3,\n \"type\": \"campaign_objectives\",\n \"attributes\": {\n \"name\": \"Promoción / Oferta / Descuento\"\n },\n \"relationships\": [],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/campaign-objective/3\"\n }\n },\n {\n \"id\": 4,\n \"type\": \"campaign_objectives\",\n \"attributes\": {\n \"name\": \"Push\"\n },\n \"relationships\": [],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/campaign-objective/4\"\n }\n }\n ]\n}"},{"id":"a6a1d281-30a5-4cb5-aa2f-670d2400a36d","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/campaign-objective?lang=es&company_id=51","host":["{{api_url}}"],"path":["campaign-objective"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"51","description":"required | integer"},{"key":"filter[name]","value":"tarea","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"order","description":"optional | array | string","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:35:05 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"d7b7a828-3476-4e67-9b45-34eecfbcce21"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"401f0b03-b3f0-4d98-8d0e-fab3b62c9c9d","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/campaign-objectives?lang=es&company_id=51","host":["{{api_url}}"],"path":["campaign-objectives"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"51","description":"required | integer"},{"key":"filter[name]","value":"tarea","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"order","description":"optional | array | string","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:35:44 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"dafaa9b9-30f2-411e-bdc9-07f624bdb04c","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/campaign-objective?lang=es&company_id=55","host":["{{api_url}}"],"path":["campaign-objective"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"tarea","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"order","description":"optional | array | string","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:36:33 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"8036eeb6-88c8-4f28-a843-1ee28f6d0981"}],"id":"ce208151-f888-41ac-abf6-ee355fdb6278","description":"Campaign Objectives provides the list of available campaign goals used by the platform (e.g., Branding / Awareness, Product Launch, etc.).
These objectives are typically used to build or validate Media Plan inputs and to ensure requests use supported goal identifiers.
This folder contains a single endpoint:
\nReturns a searchable list of audience interests that can be used to define or refine the target audience for evaluations and Media Plans.
\nUse when:
\nyou need to build an autocomplete/search field for interests
\nyou need to fetch interests available for a specific company context
\nThis endpoint requires a valid Bearer token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: /api/interest
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
/api/interest?lang=en&q=Restaurant&limit=20&company_id=55
Returned when the list is retrieved successfully.
\n\n\nSample values only.
\n
{\n \"data\": [\n {\n \"id\": \"6003436950375\",\n \"name\": \"Restaurants\",\n \"audience_size_lower_bound\": 730478154,\n \"audience_size_upper_bound\": 859042310,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Restaurants\"\n ],\n \"description\": \"\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003372667195\",\n \"name\": \"Fast food restaurants\",\n \"audience_size_lower_bound\": 169866686,\n \"audience_size_upper_bound\": 199763223,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Restaurants\",\n \"Fast food restaurants\"\n ],\n \"description\": \"\",\n \"topic\": \"Food and drink\"\n }\n ]\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when required query parameters are missing or invalid.
\n{\n \"message\": \"The q field is required. (and 1 more error)\",\n \"errors\": {\n \"q\": [\n \"The q field is required.\"\n ],\n \"company_id\": [\n \"The company id field is required.\"\n ]\n }\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/interest?lang=en&q=Restaurant&limit=20&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string [en, es, pt]
\n","type":"text/plain"},"key":"lang","value":"en"},{"description":{"content":"required | string
\n","type":"text/plain"},"key":"q","value":"Restaurant"},{"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"50"}],"variable":[]}},"response":[{"id":"614959d6-11c8-41e4-be72-984c7691a10c","name":"200 OK — Get audience interests","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/interest?lang=en&q=Restaurant&limit=20&company_id=55","host":["{{api_url}}"],"path":["interest"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"q","value":"Restaurant","description":"required | string"},{"key":"limit","value":"20","description":"optional | string"},{"key":"company_id","value":"55","description":"required | integer"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:49:56 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"0aa1cf84-0955-4187-93f3-cdd712ce4672"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"6003436950375\",\n \"name\": \"Restaurants\",\n \"audience_size_lower_bound\": 730478154,\n \"audience_size_upper_bound\": 859042310,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Restaurants\"\n ],\n \"description\": \"\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003372667195\",\n \"name\": \"Fast food restaurants\",\n \"audience_size_lower_bound\": 169866686,\n \"audience_size_upper_bound\": 199763223,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Restaurants\",\n \"Fast food restaurants\"\n ],\n \"description\": \"\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003398056603\",\n \"name\": \"Fast casual restaurants\",\n \"audience_size_lower_bound\": 127329706,\n \"audience_size_upper_bound\": 149739735,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Restaurants\",\n \"Fast casual restaurants\"\n ],\n \"description\": null,\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003154014549\",\n \"name\": \"Quick (restaurant)\",\n \"audience_size_lower_bound\": 88669540,\n \"audience_size_upper_bound\": 104275380,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Quick (restaurant)\"\n ],\n \"description\": null,\n \"topic\": \"Business and industry\"\n },\n {\n \"id\": \"6003252403167\",\n \"name\": \"Subway (restaurant)\",\n \"audience_size_lower_bound\": 54826530,\n \"audience_size_upper_bound\": 64476000,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Subway (restaurant)\"\n ],\n \"description\": null,\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003399693543\",\n \"name\": \"White Castle (restaurant)\",\n \"audience_size_lower_bound\": 15111785,\n \"audience_size_upper_bound\": 17771460,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"White Castle (restaurant)\"\n ],\n \"description\": null,\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003451978387\",\n \"name\": \"Types of restaurant\",\n \"audience_size_lower_bound\": 11397380,\n \"audience_size_upper_bound\": 13403320,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Types of restaurant\"\n ],\n \"description\": null,\n \"topic\": \"Hobbies and activities\"\n },\n {\n \"id\": \"6007289763066\",\n \"name\": \"List of fast food restaurant chains\",\n \"audience_size_lower_bound\": 2605442,\n \"audience_size_upper_bound\": 3064000,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"List of fast food restaurant chains\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Local Business\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003209775430\",\n \"name\": \"Restaurant management\",\n \"audience_size_lower_bound\": 2564488,\n \"audience_size_upper_bound\": 3015838,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Restaurant management\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Concentration or Major\",\n \"topic\": \"Business and industry\"\n },\n {\n \"id\": \"6787836449986\",\n \"name\": \"Casual dining restaurants\",\n \"audience_size_lower_bound\": 850340,\n \"audience_size_upper_bound\": 1000000,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Casual dining restaurants\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Restaurant\"\n },\n {\n \"id\": \"6003096481532\",\n \"name\": \"A&W Restaurants\",\n \"audience_size_lower_bound\": 1799328,\n \"audience_size_upper_bound\": 2116010,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"A&W Restaurants\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Local Business\",\n \"topic\": \"Business and industry\"\n },\n {\n \"id\": \"6791684440085\",\n \"name\": \"Food media and content\",\n \"audience_size_lower_bound\": 850340,\n \"audience_size_upper_bound\": 1000000,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Food media and content\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Magazine\"\n },\n {\n \"id\": \"6003379601245\",\n \"name\": \"Chinese restaurant\",\n \"audience_size_lower_bound\": 1091530,\n \"audience_size_upper_bound\": 1283640,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Chinese restaurant\"\n ],\n \"description\": null,\n \"topic\": \"Hobbies and activities\"\n },\n {\n \"id\": \"6003719320862\",\n \"name\": \"BJ's Restaurant and Brewhouse\",\n \"audience_size_lower_bound\": 992993,\n \"audience_size_upper_bound\": 1167760,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"BJ's Restaurant and Brewhouse\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"American Restaurant\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6819483565627\",\n \"name\": \"Pizza Restaurants\",\n \"audience_size_lower_bound\": 850340,\n \"audience_size_upper_bound\": 1000000,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Pizza Restaurants\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Restaurant\"\n },\n {\n \"id\": \"604424693042631\",\n \"name\": \"Barbecue restaurant\",\n \"audience_size_lower_bound\": 684770,\n \"audience_size_upper_bound\": 805290,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Barbecue restaurant\"\n ],\n \"description\": null\n },\n {\n \"id\": \"6005130299209\",\n \"name\": \"The World's 50 Best Restaurants\",\n \"audience_size_lower_bound\": 663596,\n \"audience_size_upper_bound\": 780390,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"The World's 50 Best Restaurants\"\n ],\n \"description\": null,\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003119127468\",\n \"name\": \"Fried chicken restaurant\",\n \"audience_size_lower_bound\": 438511,\n \"audience_size_upper_bound\": 515690,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Fried chicken restaurant\"\n ],\n \"description\": null,\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6003940655066\",\n \"name\": \"Ruby Tuesday (restaurant)\",\n \"audience_size_lower_bound\": 415714,\n \"audience_size_upper_bound\": 488880,\n \"path\": [\n \"Interests\",\n \"Additional interests\",\n \"Ruby Tuesday (restaurant)\"\n ],\n \"description\": null,\n \"disambiguation_category\": \"Restaurant\",\n \"topic\": \"Food and drink\"\n },\n {\n \"id\": \"6002964239317\",\n \"name\": \"Mexican cuisine\",\n \"audience_size_lower_bound\": 102614047,\n \"audience_size_upper_bound\": 120674120,\n \"path\": [\n \"Interests\",\n \"Food and drink\",\n \"Cuisine\",\n \"Mexican cuisine\"\n ],\n \"description\": \"\",\n \"topic\": \"Food and drink\"\n }\n ]\n}"},{"id":"7e0898b0-6a7a-45d0-8855-f716fcb5c5a9","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/interest?lang=en&q=Restaurant&limit=20&company_id=56","host":["{{api_url}}"],"path":["interest"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"q","value":"Restaurant","description":"required | string"},{"key":"limit","value":"20","description":"optional | string"},{"key":"company_id","value":"56","description":"required | integer"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:58:08 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"11795805-c2fd-4f51-a23a-d6be54b767b2"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"8cb78984-553f-4d24-997f-65e6904480b7","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/interests?lang=en&q=Restaurant&limit=20&company_id=50","host":["{{api_url}}"],"path":["interests"],"query":[{"key":"lang","value":"en","description":"optional | string [en, es, pt]"},{"key":"q","value":"Restaurant"},{"key":"limit","value":"20"},{"key":"company_id","value":"50"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 20:25:38 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"42bc70ce-b293-484b-889a-cc1dede88ab4","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/interest?lang=en&q=Restaurant&limit=20&company_id=55","host":["{{api_url}}"],"path":["interest"],"query":[{"key":"lang","value":"en","description":"optional | string | es,en,pt"},{"key":"q","value":"Restaurant","description":"required | string"},{"key":"limit","value":"20","description":"optional | string"},{"key":"company_id","value":"55","description":"required | integer"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 18:48:04 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"e165cdbf-39ea-437a-9ea6-7dd14c17b381"}],"id":"3429cd87-c239-4fe9-82c1-d8eba88e4d87","description":"Audience Interests provides the catalog of interest categories that can be used to define or refine a target audience for evaluations and Media Plans (e.g., “Agriculture”, “Aviation”, etc.).
\nThese interests are typically referenced in request payloads/parameters (by id and name) when building audience filters.
This folder contains a single endpoint:
\nThis endpoint calculates the recommended asset orientation (e.g., N, NE, E, SE, S, SW, W, NW) based on a geographic point and the asset physical dimensions. It is typically used when the client only has coordinates + size and needs the most suitable orientation for visualization/analysis workflows (e.g., street view framing or viewing-area calculations).
Use when:
\nYou have an asset location (latitude, longitude) and dimensions (height, width)
You need the most likely orientation to be used later in Get viewing area street view
GET {{api_url}}/asset/orientation
Accept: application/json
Authorization: Bearer {{token}} (if protected)
Returned when the list is retrieved successfully.
\n\n\nSample values only.
\n
{\n \"latitude\": -34.543177346959695,\n \"longitude\": -58.49550645394661,\n \"width\": 2,\n \"height\": 1,\n \"media_area\": 2,\n \"visual_range\": 30.604026845637584,\n \"media_orientation\": \"NW/SE\",\n \"main_road\": {\n \"id\": 226508742,\n \"name\": \"Blas Parera\",\n \"type\": \"tertiary\",\n \"lanes\": \"2\",\n \"road_orientation\": \"SE/NW\",\n \"road_coordinates\": [\n [\n -58.4951828,\n -34.5437532\n ],\n [\n -58.4952722,\n -34.5436936\n ],\n [\n -58.4958515,\n -34.5428717\n ],\n [\n -58.4965352,\n -34.5419766\n ],\n [\n -58.4972007,\n -34.5411972\n ],\n [\n -58.4972773,\n -34.5411117\n ]\n ]\n }\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/asset/orientation?longitude=-58.49550645394661&latitude=-34.543177346959695&height=1&width=2&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\nrequired | float
\n","type":"text/plain"},"key":"longitude","value":"-58.49550645394661"},{"description":{"content":"required | float
\n","type":"text/plain"},"key":"latitude","value":"-34.543177346959695"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"height","value":"1"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"width","value":"2"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"}],"variable":[]}},"response":[{"id":"30d07dfa-743a-4a37-9232-43ed50f8122c","name":"200 OK — Get orientation","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/asset/orientation?longitude=-58.49550645394661&latitude=-34.543177346959695&height=1&width=2&company_id=55","host":["{{api_url}}"],"path":["asset","orientation"],"query":[{"key":"longitude","value":"-58.49550645394661"},{"key":"latitude","value":"-34.543177346959695"},{"key":"height","value":"1"},{"key":"width","value":"2"},{"key":"company_id","value":"55"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:47:07 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"3e6a4cb5-a7ac-4bf1-8411-0922c44a3913"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"latitude\": -34.543177346959695,\n \"longitude\": -58.49550645394661,\n \"width\": 2,\n \"height\": 1,\n \"media_area\": 2,\n \"visual_range\": 30.604026845637584,\n \"media_orientation\": \"NW/SE\",\n \"main_road\": {\n \"id\": 226508742,\n \"name\": \"Blas Parera\",\n \"type\": \"tertiary\",\n \"lanes\": \"2\",\n \"road_orientation\": \"SE/NW\",\n \"road_coordinates\": [\n [\n -58.4951828,\n -34.5437532\n ],\n [\n -58.4952722,\n -34.5436936\n ],\n [\n -58.4958515,\n -34.5428717\n ],\n [\n -58.4965352,\n -34.5419766\n ],\n [\n -58.4972007,\n -34.5411972\n ],\n [\n -58.4972773,\n -34.5411117\n ]\n ]\n }\n}"},{"id":"4b2a67b9-c9f0-4c09-82e1-a1b7d120db26","name":"401 Unauthorized — Invalid Credentials","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/asset/orientation?longitude=-58.49550645394661&latitude=-34.543177346959695&height=1&width=2&company_id=50","host":["{{api_url}}"],"path":["asset","orientation"],"query":[{"key":"longitude","value":"-58.49550645394661"},{"key":"latitude","value":"-34.543177346959695"},{"key":"height","value":"1"},{"key":"width","value":"2"},{"key":"company_id","value":"50"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:48:19 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"7c707ad9-1412-4fa5-96ab-805aabd81f0c"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"2d999a2b-42a2-416d-83a6-5710e659f7f9","name":"404 Not Found — Resource Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/assets/orientation?longitude=-58.49550645394661&latitude=-34.543177346959695&height=1&width=2&company_id=55","host":["{{api_url}}"],"path":["assets","orientation"],"query":[{"key":"longitude","value":"-58.49550645394661"},{"key":"latitude","value":"-34.543177346959695"},{"key":"height","value":"1"},{"key":"width","value":"2"},{"key":"company_id","value":"55"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:49:24 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"a1aa33f0-b39f-4b11-b5e8-4712b2b46c81","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/asset/orientation?longitude=-58.49550645394661&latitude=-34.543177346959695&height=1&width=2&company_id=55","host":["{{api_url}}"],"path":["asset","orientation"],"query":[{"key":"longitude","value":"-58.49550645394661"},{"key":"latitude","value":"-34.543177346959695"},{"key":"height","value":"1"},{"key":"width","value":"2"},{"key":"company_id","value":"55"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:50:16 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"a97b6c92-ba19-439b-bcda-16ea08249de9"},{"name":"Get viewing area street view","id":"e2368e0a-6716-4141-ba5a-906151e50b12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=55","description":"Returns street-level viewing information for an asset using its orientation, visual range, and coordinates. This helps estimate or validate the viewing corridor/area from a street view perspective.
Use when: you want to calculate or validate the visible area/range of an asset for planning or QA.
Typical inputs: orientation, visual_range, latitude, longitude, lang, company_id.
GET {{api_url}}/asset/viewing-area-street-view
Returns an estimated street-view viewing area (visibility footprint) based on:
\nA known asset orientation
\nA visual range value (distance/radius used by your model)
\nCoordinates (latitude/longitude)
\nThis is useful for map rendering, visibility simulation, and downstream planning calculations.
\nAccept: application/json
Authorization: Bearer {{token}} (if required)
Returned when the list is retrieved successfully.
\n\n\nSample values only.
\n
{\n \"location\": {\n \"coordinates\": {\n \"latitude\": -34.900336,\n \"longitude\": -56.160214\n }\n },\n \"visibility\": {\n \"street_view_link\": \"https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=-34.900473839447905,-56.160045933552965&heading=315&pitch=0&fov=60\",\n \"viewing_area\": {\n \"type\": \"Feature\",\n \"geometry\": {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -56.160214,\n -34.900336\n ],\n [\n -56.15991994497278,\n -34.900196761130964\n ],\n [\n -56.159906267270884,\n -34.90021831022241\n ],\n [\n -56.159894931600874,\n -34.90024075500411\n ],\n [\n -56.15988602423404,\n -34.90026392465775\n ],\n [\n -56.15987961296082,\n -34.90028764284826\n ],\n [\n -56.15987574657488,\n -34.900311729065905\n ],\n [\n -56.15987445450175,\n -34.900336\n ],\n [\n -56.15987574657488,\n -34.9003602709341\n ],\n [\n -56.15987961296082,\n -34.900384357151744\n ],\n [\n -56.15988602423404,\n -34.900408075342256\n ],\n [\n -56.159894931600874,\n -34.90043124499589\n ],\n [\n -56.159906267270884,\n -34.9004536897776\n ],\n [\n -56.15991994497278,\n -34.90047523886904\n ],\n [\n -56.15993586061098,\n -34.90049572826861\n ],\n [\n -56.15995389305788,\n -34.90051500203961\n ],\n [\n -56.15997390507567,\n -34.90053291349701\n ],\n [\n -56.1599957443608,\n -34.90054932632379\n ],\n [\n -56.160019244703136,\n -34.90056411560844\n ],\n [\n -56.16004422725088,\n -34.900577168795564\n ],\n [\n -56.16007050187175,\n -34.90058838654254\n ],\n [\n -56.160097868600026,\n -34.900597683475524\n ],\n [\n -56.16012611915838,\n -34.900604988839255\n ],\n [\n -56.160155038542996,\n -34.9006102470355\n ],\n [\n -56.16018440665991,\n -34.90061341804621\n ],\n [\n -56.160214,\n -34.90061447773808\n ],\n [\n -56.1602435933401,\n -34.90061341804621\n ],\n [\n -56.16027296145701,\n -34.9006102470355\n ],\n [\n -56.16030188084163,\n -34.900604988839255\n ],\n [\n -56.16033013139998,\n -34.900597683475524\n ],\n [\n -56.160357498128256,\n -34.90058838654254\n ],\n [\n -56.16038377274913,\n -34.900577168795564\n ],\n [\n -56.160214,\n -34.900336\n ]\n ]\n ]\n },\n \"properties\": {\n \"center\": [\n -56.160214,\n -34.900336\n ],\n \"orientation\": \"SE\",\n \"visual_range\": {\n \"value\": 31,\n \"unit\": \"m\"\n }\n }\n }\n }\n}\n\nReturned when the request does not include a valid Bearer token.
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the route is incorrect or not available.
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\nrequired | string
\n","type":"text/plain"},"key":"orientation","value":"SE"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"visual_range","value":"31"},{"description":{"content":"required | float
\n","type":"text/plain"},"key":"latitude","value":"-34.900336"},{"description":{"content":"required | float
\n","type":"text/plain"},"key":"longitude","value":"-56.160214"},{"description":{"content":"optional | string [en, es, pt]
\n","type":"text/plain"},"key":"lang","value":"en"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"}],"variable":[]}},"response":[{"id":"03ee920b-40ca-4488-b6ed-3263b88337c2","name":"200 OK — Get viewing area street view","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=55","host":["{{api_url}}"],"path":["asset","viewing-area-street-view"],"query":[{"key":"orientation","value":"SE"},{"key":"visual_range","value":"31"},{"key":"latitude","value":"-34.900336"},{"key":"longitude","value":"-56.160214"},{"key":"lang","value":"en"},{"key":"company_id","value":"55"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:59:48 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"b19b03ff-967b-4b1e-98e9-23e37acbd9c9"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"57"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"location\": {\n \"coordinates\": {\n \"latitude\": -34.900336,\n \"longitude\": -56.160214\n }\n },\n \"visibility\": {\n \"street_view_link\": \"https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=-34.900473839447905,-56.160045933552965&heading=315&pitch=0&fov=60\",\n \"viewing_area\": {\n \"type\": \"Feature\",\n \"geometry\": {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -56.160214,\n -34.900336\n ],\n [\n -56.15991994497278,\n -34.900196761130964\n ],\n [\n -56.159906267270884,\n -34.90021831022241\n ],\n [\n -56.159894931600874,\n -34.90024075500411\n ],\n [\n -56.15988602423404,\n -34.90026392465775\n ],\n [\n -56.15987961296082,\n -34.90028764284826\n ],\n [\n -56.15987574657488,\n -34.900311729065905\n ],\n [\n -56.15987445450175,\n -34.900336\n ],\n [\n -56.15987574657488,\n -34.9003602709341\n ],\n [\n -56.15987961296082,\n -34.900384357151744\n ],\n [\n -56.15988602423404,\n -34.900408075342256\n ],\n [\n -56.159894931600874,\n -34.90043124499589\n ],\n [\n -56.159906267270884,\n -34.9004536897776\n ],\n [\n -56.15991994497278,\n -34.90047523886904\n ],\n [\n -56.15993586061098,\n -34.90049572826861\n ],\n [\n -56.15995389305788,\n -34.90051500203961\n ],\n [\n -56.15997390507567,\n -34.90053291349701\n ],\n [\n -56.1599957443608,\n -34.90054932632379\n ],\n [\n -56.160019244703136,\n -34.90056411560844\n ],\n [\n -56.16004422725088,\n -34.900577168795564\n ],\n [\n -56.16007050187175,\n -34.90058838654254\n ],\n [\n -56.160097868600026,\n -34.900597683475524\n ],\n [\n -56.16012611915838,\n -34.900604988839255\n ],\n [\n -56.160155038542996,\n -34.9006102470355\n ],\n [\n -56.16018440665991,\n -34.90061341804621\n ],\n [\n -56.160214,\n -34.90061447773808\n ],\n [\n -56.1602435933401,\n -34.90061341804621\n ],\n [\n -56.16027296145701,\n -34.9006102470355\n ],\n [\n -56.16030188084163,\n -34.900604988839255\n ],\n [\n -56.16033013139998,\n -34.900597683475524\n ],\n [\n -56.160357498128256,\n -34.90058838654254\n ],\n [\n -56.16038377274913,\n -34.900577168795564\n ],\n [\n -56.160214,\n -34.900336\n ]\n ]\n ]\n },\n \"properties\": {\n \"center\": [\n -56.160214,\n -34.900336\n ],\n \"orientation\": \"SE\",\n \"visual_range\": {\n \"value\": 31,\n \"unit\": \"m\"\n }\n }\n }\n }\n}"},{"id":"a5241231-ca22-49ad-a279-3dead8232448","name":"401 Unauthorized — Invalid Credentials","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=50","host":["{{api_url}}"],"path":["asset","viewing-area-street-view"],"query":[{"key":"orientation","value":"SE"},{"key":"visual_range","value":"31"},{"key":"latitude","value":"-34.900336"},{"key":"longitude","value":"-56.160214"},{"key":"lang","value":"en"},{"key":"company_id","value":"50"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:59:19 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"3f3d3a00-1892-4170-9680-65b722fe22f5"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"958d8b71-dd40-4382-820a-543264a7f178","name":"404 Not Found — Resource Not Found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=55","host":["{{api_url}}"],"path":["asset","viewing-area-street-view"],"query":[{"key":"orientation","value":"SE"},{"key":"visual_range","value":"31"},{"key":"latitude","value":"-34.900336"},{"key":"longitude","value":"-56.160214"},{"key":"lang","value":"en"},{"key":"company_id","value":"55"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:56:52 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"db0ae3cb-cc11-4580-bbfe-1fd26970e7b5","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_url}}/asset/viewing-area-street-view?orientation=SE&visual_range=31&latitude=-34.900336&longitude=-56.160214&lang=en&company_id=55","host":["{{api_url}}"],"path":["asset","viewing-area-street-view"],"query":[{"key":"orientation","value":"SE"},{"key":"visual_range","value":"31"},{"key":"latitude","value":"-34.900336"},{"key":"longitude","value":"-56.160214"},{"key":"lang","value":"en"},{"key":"company_id","value":"55"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Feb 2026 13:50:50 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"e2368e0a-6716-4141-ba5a-906151e50b12"}],"id":"b4f1548b-838a-457a-a1f0-ed45a9c08ca8","description":"Observations provides helper endpoints used to enrich OOH asset data with field-ready context derived from coordinates and viewing conditions. These endpoints are typically used during asset validation, planning, and reporting to standardize orientation and to estimate how an asset is perceived from street level.
\nThis folder includes two endpoints that support the workflow:
\nGET — Get orientation{{api_url}}/asset/orientation
Returns the recommended orientation for an asset based on its latitude/longitude and the asset’s physical dimensions (height/width).
Use when: you have coordinates and need to determine/normalize the asset facing direction (e.g., for mapping, inventory validation, or media plan inputs).
Typical inputs: latitude, longitude, height, width, company_id.
GET — Get viewing area street view{{api_url}}/asset/viewing-area-street-view
Returns street-level viewing information for an asset using its orientation, visual range, and coordinates. This helps estimate or validate the viewing corridor/area from a street view perspective.
Use when: you want to calculate or validate the visible area/range of an asset for planning or QA.
Typical inputs: orientation, visual_range, latitude, longitude, lang, company_id.
Get orientation from coordinates and dimensions
\nGet viewing area street view using the orientation + visual parameters
\nBase URL: {{api_url}}
Default header: Accept: application/json
If protected, include: Authorization: Bearer {{token}}
These endpoints typically use:
\n200 success
\n401 unauthorized (missing/invalid token)
\n404 not found (resource/route not available)
\n500 unexpected server error
\nRetrieves the complete list of Advertiser / Account Categories available for the given company scope.
Supports optional filtering (by name or by specific IDs) and sorting.
Use this endpoint to populate dropdowns, caches, and selector components.
This endpoint requires a valid Bearer Token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: {{api_url}}/account-categories
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
{{api_url}}/account-categories?lang=pt&company_id=55&filter[name]=&sort[]=name&sort[]=level
Content-Type: application/json
Example Response (200)
\n{\n \"data\": [\n {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuária\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n },\n {\n \"id\": 13,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21100\",\n \"name\": \"Alimentos\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/13\"\n }\n }\n ],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories\"\n },\n \"included\": []\n}\n\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/account-categories?lang=pt&company_id=55&sort[]=name&sort[]=level' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"pt"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"56"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[name]","value":""},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[id][]","value":"1"},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"name"},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"level"},{"disabled":true,"key":"sort[]","value":"createdAt"}],"variable":[]}},"response":[{"id":"84043512-7b6d-419a-8374-ca4f1b102888","name":"200 OK — Get all account categories","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories?lang=pt&company_id=55&filter[name]=&sort[]=name&sort[]=level","host":["{{api_url}}"],"path":["account-categories"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string"},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string"},{"key":"sort[]","value":"level","description":"optional | array | string"},{"key":"sort[]","value":"createdAt","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 20:51:35 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"b5fa9a3f-eaa7-4621-b626-f630677c5da7"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuária\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n },\n {\n \"id\": 13,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21100\",\n \"name\": \"Alimentos\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/13\"\n }\n },\n {\n \"id\": 14,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21200\",\n \"name\": \"Apostas e Loterias\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/14\"\n }\n },\n {\n \"id\": 1,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"10000\",\n \"name\": \"Artes e Entretenimento\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/1\"\n }\n },\n {\n \"id\": 15,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21300\",\n \"name\": \"Automotivo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/15\"\n }\n },\n {\n \"id\": 16,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21400\",\n \"name\": \"Bebidas\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/16\"\n }\n },\n {\n \"id\": 17,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21500\",\n \"name\": \"Campanhas Cívicas e Governamentais\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/17\"\n }\n },\n {\n \"id\": 18,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21600\",\n \"name\": \"Comércio e Turismo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/18\"\n }\n },\n {\n \"id\": 4,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"13000\",\n \"name\": \"Comer e Beber\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/4\"\n }\n },\n {\n \"id\": 3,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"12000\",\n \"name\": \"Comunidade e Governo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/3\"\n }\n },\n {\n \"id\": 19,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21700\",\n \"name\": \"Diversão e Entretenimento\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/19\"\n }\n },\n {\n \"id\": 20,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21800\",\n \"name\": \"Educação\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/20\"\n }\n },\n {\n \"id\": 30,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22800\",\n \"name\": \"Escritório e Papelaria\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/30\"\n }\n },\n {\n \"id\": 9,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"18000\",\n \"name\": \"Esportes e Lazer\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/9\"\n }\n },\n {\n \"id\": 5,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"14000\",\n \"name\": \"Evento\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/5\"\n }\n },\n {\n \"id\": 21,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21900\",\n \"name\": \"Farmacêutico\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/21\"\n }\n },\n {\n \"id\": 22,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22000\",\n \"name\": \"Financeiro e Seguros\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/22\"\n }\n },\n {\n \"id\": 23,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22100\",\n \"name\": \"Higiene Doméstica\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/23\"\n }\n },\n {\n \"id\": 24,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22200\",\n \"name\": \"Higiene Pessoal e Beleza\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/24\"\n }\n },\n {\n \"id\": 26,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22400\",\n \"name\": \"Indústria e Construção\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/26\"\n }\n },\n {\n \"id\": 11,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"20000\",\n \"name\": \"Instituição Educacional\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/11\"\n }\n },\n {\n \"id\": 27,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22500\",\n \"name\": \"Internet\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/27\"\n }\n },\n {\n \"id\": 25,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22300\",\n \"name\": \"Lar, Eletrodomésticos e Gás Doméstico\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/25\"\n }\n },\n {\n \"id\": 28,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22600\",\n \"name\": \"Mídia e Conteúdo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/28\"\n }\n },\n {\n \"id\": 7,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"16000\",\n \"name\": \"Monumentos e Ao Ar Livre\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/7\"\n }\n },\n {\n \"id\": 29,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"22700\",\n \"name\": \"Móveis e Decoração\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/29\"\n }\n },\n {\n \"id\": 31,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"23000\",\n \"name\": \"Saúde e Esportes\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/31\"\n }\n },\n {\n \"id\": 6,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"15000\",\n \"name\": \"Saúde e Medicina\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/6\"\n }\n },\n {\n \"id\": 32,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"23100\",\n \"name\": \"Serviços\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/32\"\n }\n },\n {\n \"id\": 2,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"11000\",\n \"name\": \"Serviços Profissionais e Empresariais\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/2\"\n }\n },\n {\n \"id\": 33,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"23200\",\n \"name\": \"Tecnologia\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/33\"\n }\n },\n {\n \"id\": 34,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"23300\",\n \"name\": \"Telecomunicações\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/34\"\n }\n },\n {\n \"id\": 8,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"17000\",\n \"name\": \"Varejo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/8\"\n }\n },\n {\n \"id\": 35,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"23400\",\n \"name\": \"Vestuário e Acessórios\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/35\"\n }\n },\n {\n \"id\": 10,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"19000\",\n \"name\": \"Viagens e Transporte\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n }\n ],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories\"\n },\n \"included\": []\n}"},{"id":"da32173a-85f6-4fd2-9f8e-8f03364ad894","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories?lang=pt&company_id=56&filter[name]=&sort[]=name&sort[]=level","host":["{{api_url}}"],"path":["account-categories"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"56","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string"},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string"},{"key":"sort[]","value":"level","description":"optional | array | string"},{"key":"sort[]","value":"createdAt","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 20:52:59 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"95d73291-ada7-4235-b8da-05a08d17b522"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"c85be95a-fce3-4fa8-be2f-df8135afd3d1","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts-categories?lang=pt&company_id=56&filter[name]=&sort[]=name&sort[]=level","host":["{{api_url}}"],"path":["accounts-categories"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"56","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string"},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string"},{"key":"sort[]","value":"level","description":"optional | array | string"},{"key":"sort[]","value":"createdAt","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 20:53:49 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"410f6993-3eea-438f-b420-1b836c029f0d","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories?lang=pt&company_id=56&filter[name]=&sort[]=name&sort[]=level","host":["{{api_url}}"],"path":["account-categories"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"56","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string"},{"key":"filter[id][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string"},{"key":"sort[]","value":"level","description":"optional | array | string"},{"key":"sort[]","value":"createdAt","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 20:56:22 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"a14bd499-c3fe-41fc-a2ab-84f4b9cc1233"},{"name":"Get account categories paginated","id":"e81b6e88-1175-4269-b34a-b2c91776c4e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"{{api_url}}/account-categories/paginated?lang=pt&company_id=55","description":"Returns a paginated list of Account Categories (Advertiser/Industry taxonomy) scoped by company_id.
Supports optional filtering and sorting, and includes pagination metadata for UI lists, tables, and search screens.
Use when: you need to browse categories with pagination (dashboards, admin screens, typeahead + paging, etc.).
\nThis endpoint requires a valid Bearer Token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: {{api_url}}/account-categories/paginated
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
{{api_url}}/account-categories/paginated?lang=pt&company_id=55&page=1&per_page=25&filter[name]=food&sort[]=name&sort[]=level
Content-Type: application/json
Response shape
\ndata: array of account_categories
links: pagination links (first, last, prev, next)
meta: pagination metadata (current_page, per_page, total_pages, total_items)
included: optional related resources (often empty)
Example Response (200)
\n{\n \"data\": [\n {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuária\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=1\",\n \"last\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=10\",\n \"prev\": null,\n \"next\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=2\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 250,\n \"per_page\": 25,\n \"total_pages\": 10\n },\n \"included\": []\n}\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized.\"\n}\n\nStartFragment
\nReturned when the route is incorrect or the resource is not available.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/account-categories/paginated?lang=pt&company_id=55&page=1&per_page=25&sort[]=name&sort[]=level' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"pt"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[name]","value":""},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[id][]","value":""},{"disabled":true,"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"name"},{"disabled":true,"key":"sort[]","value":"createdAt"},{"disabled":true,"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[number]","value":"1"},{"disabled":true,"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[size]","value":"1"}],"variable":[]}},"response":[{"id":"d77cd531-f404-4c0e-a600-ead953f194f5","name":"200 OK — Get account categories paginated","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/paginated?lang=pt&company_id=55","host":["{{api_url}}"],"path":["account-categories","paginated"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","type":"text","disabled":true},{"key":"sort[]","value":"createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer","disabled":true},{"key":"page[size]","value":"1","description":"optional | integer","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:09:49 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"9b3f1458-917a-465e-8d73-cfacbe3f14e7"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"10000\",\n \"name\": \"Artes e Entretenimento\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/1\"\n }\n },\n {\n \"id\": 2,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"11000\",\n \"name\": \"Serviços Profissionais e Empresariais\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/2\"\n }\n },\n {\n \"id\": 3,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"12000\",\n \"name\": \"Comunidade e Governo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/3\"\n }\n },\n {\n \"id\": 4,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"13000\",\n \"name\": \"Comer e Beber\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/4\"\n }\n },\n {\n \"id\": 5,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"14000\",\n \"name\": \"Evento\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/5\"\n }\n },\n {\n \"id\": 6,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"15000\",\n \"name\": \"Saúde e Medicina\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/6\"\n }\n },\n {\n \"id\": 7,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"16000\",\n \"name\": \"Monumentos e Ao Ar Livre\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/7\"\n }\n },\n {\n \"id\": 8,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"17000\",\n \"name\": \"Varejo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/8\"\n }\n },\n {\n \"id\": 9,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"18000\",\n \"name\": \"Esportes e Lazer\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/9\"\n }\n },\n {\n \"id\": 10,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"19000\",\n \"name\": \"Viagens e Transporte\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n {\n \"id\": 11,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"20000\",\n \"name\": \"Instituição Educacional\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/11\"\n }\n },\n {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuária\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n },\n {\n \"id\": 13,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21100\",\n \"name\": \"Alimentos\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/13\"\n }\n },\n {\n \"id\": 14,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21200\",\n \"name\": \"Apostas e Loterias\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/14\"\n }\n },\n {\n \"id\": 15,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21300\",\n \"name\": \"Automotivo\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/15\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=1\",\n \"last\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=3\",\n \"prev\": null,\n \"next\": \"http://localhost/api-evaluator/public/api/account-categories/paginated?page=2\",\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 35,\n \"per_page\": 15,\n \"total_pages\": 3\n },\n \"included\": []\n}"},{"id":"8e847277-efb0-4afa-875b-01e3467fbd94","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts-categories/paginated?lang=pt&company_id=47","host":["{{api_url}}"],"path":["accounts-categories","paginated"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","type":"text","disabled":true},{"key":"sort[]","value":"createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer","disabled":true},{"key":"page[size]","value":"1","description":"optional | integer","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:08:00 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"ef94505e-114d-4a64-9bc7-b5e79d53b70d"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"a45b5768-ec7c-4095-9787-167bb50a410a","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/paginated?lang=pt&company_id=55","host":["{{api_url}}"],"path":["account-categories","paginated"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","type":"text","disabled":true},{"key":"sort[]","value":"createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer","disabled":true},{"key":"page[size]","value":"1","description":"optional | integer","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:08:57 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"8569c314-d3b5-4446-8622-49e1352ac9e4","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/paginated?lang=pt&company_id=47","host":["{{api_url}}"],"path":["account-categories","paginated"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[name]","value":"","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","type":"text","disabled":true},{"key":"sort[]","value":"createdAt","disabled":true},{"key":"page[number]","value":"1","description":"optional | integer","disabled":true},{"key":"page[size]","value":"1","description":"optional | integer","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:04:43 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"e81b6e88-1175-4269-b34a-b2c91776c4e7"},{"name":"Get account category by id","id":"1b4583de-930f-4b2b-aae9-c10a92661636","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"{{api_url}}/account-categories/:accountType?lang=es&company_id=47","description":"Retrieves the details of a single Account Category by its unique identifier.
\nUse when: you already have an account_category_id and need to display or validate the category info (level, external_id, name, etc.).
This endpoint requires a valid Bearer Token.
\nAuthorization: Bearer {{token}}Method: GET
Endpoint: {{api_url}}/account-categories/:id
Headers
\nAccept: application/json
Authorization: Bearer {{token}}
*If your implementation does not require company_id for this endpoint, remove it from Postman. Many setups keep it for consistent scoping/authorization.
Content-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuária\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n }\n}\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized.\"\n}\n\nReturned when the category ID does not exist or the route is incorrect.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/account-categories/12?lang=pt&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"es"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"47"}],"variable":[{"id":"849596f1-c2a0-445b-b030-813b20cc584f","type":"any","value":"1","key":"accountType"}]}},"response":[{"id":"fead294e-92c2-44de-b9cd-90475a7ee035","name":"200 OK — Get account category by id","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/:accountType?lang=es&company_id=55","host":["{{api_url}}"],"path":["account-categories",":accountType"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"}],"variable":[{"key":"accountType","value":"12"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:19:45 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"f09e352c-a3e6-482c-b44b-efcba45d3453"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": 12,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"21000\",\n \"name\": \"Agropecuaria\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/12\"\n }\n }\n}"},{"id":"7c8f437e-10da-41b7-9019-e51de4f90c18","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/:accountType?lang=es&company_id=47","host":["{{api_url}}"],"path":["account-categories",":accountType"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"}],"variable":[{"key":"accountType","value":"12"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:19:13 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"75e3810c-89df-4704-b58f-3e00da2f02b4"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"ffe8f4c2-a77c-4efc-8c27-8f0d2f1609e2","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts-categories/:accountType?lang=es&company_id=55","host":["{{api_url}}"],"path":["accounts-categories",":accountType"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"}],"variable":[{"key":"accountType","value":"12"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:24:18 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"78fa796e-0f09-4d84-8b11-1f572bc38361","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account-categories/:accountType?lang=es&company_id=55","host":["{{api_url}}"],"path":["account-categories",":accountType"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"}],"variable":[{"key":"accountType","value":"12"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:25:13 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"1b4583de-930f-4b2b-aae9-c10a92661636"}],"id":"04305cc2-433f-40af-937b-83dce95a45af","description":"Advertisers Categories define the classification catalog used to group Advertisers (Accounts) (e.g., industry/category groupings). These categories are commonly used to power filters, dropdowns, reporting segments, and advertiser setup flows.
\nThis folder includes three read-only endpoints that cover the full “browse + find + detail” workflow.
\nGET — Get all account categories
\nReturns the full list of available advertiser/account categories (unpaginated).
Use when: you need the complete catalog for dropdowns, caches, or small datasets.
GET — Get account categories paginated
\nReturns a paginated list of categories, usually for admin panels, search, or large catalogs.
Use when: you need browsing, listing, or pagination support.
GET — Get account category by id
\nRetrieves the details of a single category by its unique identifier.
Use when: you already have a category_id and need its full details.
Fetch list (unpaginated) for dropdowns or fetch paginated for browsing/search
\nRetrieve a category by ID when you need to display or validate a specific category
\nBase URL: {{api_url}}
Default header: Accept: application/json
If the endpoint is protected, include:Authorization: Bearer {{token}}
These endpoints typically use:
\n200 success
\n401 unauthorized (missing/invalid token)
\n404 not found (resource not available)
\n422 validation error (missing/invalid fields)
\n500 unexpected server error
\nReturns the complete list of advertisers available for the authenticated context (typically scoped by company_id / permissions).
Use when: you need to populate dropdowns/selectors or fetch the full advertiser catalog (non-paginated).
This endpoint requires an access token.
\nHeaders
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: GET
Endpoint: {{api_url}}/advertisers
Content-Type: application/json
Example Response (200)
\n{\n \"data\": [\n {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"logo\": [],\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": {\n \"data\": [\n {\n \"id\": 317,\n \"name\": \"inDrive\",\n \"type\": \"brands\"\n }\n ]\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n ],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts\"\n },\n \"included\": [\n {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n ]\n}\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/account?lang=es&company_id=55&sort[]=-createdAt&include[]=brand' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"es"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[text]","value":"uruguay"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[id][]","value":""},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[type][]","value":"1"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[disabled]","value":"true"},{"disabled":true,"key":"filter[category][]","value":"8"},{"disabled":true,"key":"filter[company]","value":"47"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[brand][]","value":"54"},{"disabled":true,"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"name"},{"description":{"content":"optional | array | string
\n","type":"text/plain"},"key":"sort[]","value":"-createdAt"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"country"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"type"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"logo"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"category"},{"disabled":true,"key":"include[]","value":"checkDisable"},{"disabled":true,"key":"include[]","value":"checkDelete"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"brand"}],"variable":[]}},"response":[{"id":"33b248d6-5c1b-4d1c-9246-c4d397ccb4e8","name":"200 OK — Get all advertiser","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts?lang=es&company_id=55&sort[]=-createdAt&include[]=brand","host":["{{api_url}}"],"path":["accounts"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"filter[category][]","value":"8","disabled":true},{"key":"filter[company]","value":"47","disabled":true},{"key":"filter[brand][]","value":"54","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","description":"optional | array | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string","disabled":true},{"key":"include[]","value":"logo","description":"optional | string","disabled":true},{"key":"include[]","value":"category","description":"optional | string","disabled":true},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","type":"text","disabled":true},{"key":"include[]","value":"brand","description":"optional | string"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:39:54 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"f82c6e89-e85b-4517-bd9b-73fe448f0bab"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"logo\": [],\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": {\n \"data\": [\n {\n \"id\": 317,\n \"name\": \"inDrive\",\n \"type\": \"brands\"\n }\n ]\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n ],\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts\"\n },\n \"included\": [\n {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n ]\n}"},{"id":"1e22fa29-9a6d-4db4-b383-117257fbb6fb","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts?lang=es&company_id=47&sort[]=-createdAt&include[]=brand","host":["{{api_url}}"],"path":["accounts"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"filter[category][]","value":"8","disabled":true},{"key":"filter[company]","value":"47","disabled":true},{"key":"filter[brand][]","value":"54","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","description":"optional | array | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string","disabled":true},{"key":"include[]","value":"logo","description":"optional | string","disabled":true},{"key":"include[]","value":"category","description":"optional | string","disabled":true},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","type":"text","disabled":true},{"key":"include[]","value":"brand","description":"optional | string"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:37:34 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"db78e48e-8936-418e-a738-e0abf610ce16"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"8e4b00d1-413a-455f-bdda-796affc10017","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/account?lang=es&company_id=47&sort[]=-createdAt&include[]=brand","host":["{{api_url}}"],"path":["account"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"1","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"filter[category][]","value":"8","disabled":true},{"key":"filter[company]","value":"47","disabled":true},{"key":"filter[brand][]","value":"54","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","description":"optional | array | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string","disabled":true},{"key":"include[]","value":"logo","description":"optional | string","disabled":true},{"key":"include[]","value":"category","description":"optional | string","disabled":true},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","type":"text","disabled":true},{"key":"include[]","value":"brand","description":"optional | string"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:39:14 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"ee1f5fd8-9726-41cb-9094-036b2de614be","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/accounts?lang=es&company_id=47&filter[type][]=1&filter[disabled]=true&sort[]=-createdAt&include[]=brand","host":["{{api_url}}"],"path":["accounts"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"1","description":"optional | array | integer"},{"key":"filter[disabled]","value":"true","description":"optional | string"},{"key":"filter[category][]","value":"8","disabled":true},{"key":"filter[company]","value":"47","disabled":true},{"key":"filter[brand][]","value":"54","description":"optional | array | integer","disabled":true},{"key":"sort[]","value":"name","description":"optional | array | string","disabled":true},{"key":"sort[]","value":"-createdAt","description":"optional | array | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string","disabled":true},{"key":"include[]","value":"logo","description":"optional | string","disabled":true},{"key":"include[]","value":"category","description":"optional | string","disabled":true},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","type":"text","disabled":true},{"key":"include[]","value":"brand","description":"optional | string"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 09 Feb 2026 21:35:24 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"3829fd35-fc6c-4555-9473-978c34814c3c"},{"name":"Get all brands by advertiser","id":"0c2d813b-b1f4-485e-aaef-9003d06a43c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"{{api_url}}/brands?lang=es&company_id=47","description":"Retrieves brands associated with advertisers (accounts) for a given company.
\nYou can optionally filter by company or a specific account.
\nUse when: you need to populate brand selectors, advertiser-brand mapping screens, or dependent dropdowns (Advertiser → Brands).
\nThis endpoint requires a valid access token.
\nHeader
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: GET
URL: {{api_url}}/brands
{{api_url}}/brands?lang=es&company_id=55
Content-Type: application/json
Example Response (200)
\n{\n \"data\": [\n {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n ]\n}\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/brands?lang=es&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"es"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"47"},{"disabled":true,"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"filter[company]","value":"47"},{"disabled":true,"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"filter[account]","value":""}],"variable":[]}},"response":[{"id":"979cc897-ac28-4a07-a78f-5e927d62c291","name":"200 OK — Get all brands by advertiser","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/brands?lang=es&company_id=55","host":["{{api_url}}"],"path":["brands"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[company]","value":"47","description":"optional | integer","disabled":true},{"key":"filter[account]","value":"","description":"optional | integer","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:28:50 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"3971e9e7-6822-460a-8f57-6a156eb23359"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n ]\n}"},{"id":"84acb601-8c72-4fd5-a003-de7f0410f246","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/brands?lang=es&company_id=47","host":["{{api_url}}"],"path":["brands"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[company]","value":"47","description":"optional | integer","disabled":true},{"key":"filter[account]","value":"","description":"optional | integer","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:27:30 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"39ed56bb-7383-47e5-be8e-4680f1c8917b"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"bb90f42e-2e5b-4100-8789-327a3a3058e3","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/brand?lang=es&company_id=55","host":["{{api_url}}"],"path":["brand"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[company]","value":"47","description":"optional | integer","disabled":true},{"key":"filter[account]","value":"","description":"optional | integer","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:28:16 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"d5c1e4dc-cfa7-41fa-b5d7-d403e9263ba2","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"{{api_url}}/brands?lang=es&company_id=55","host":["{{api_url}}"],"path":["brands"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[company]","value":"47","description":"optional | integer","disabled":true},{"key":"filter[account]","value":"","description":"optional | integer","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:32:13 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"0c2d813b-b1f4-485e-aaef-9003d06a43c0"},{"name":"Get advertisers paginated","id":"1dbc088e-a8a2-442f-9b88-a1bf2db11a33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{api_url}}/accounts/paginated?lang=es&company_id=47&filter[disabled]=true&sort[]=createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=2","description":"Returns a paginated list of Advertisers (Accounts) for the given company.
\nSupports filters, sorting, includes, and standard pagination params.
\nUse when: you need advertiser listing screens, dashboards, history views, or any UI that requires pagination.
\nThis endpoint requires a valid access token.
\nHeaders
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: GET
URL: {{api_url}}/accounts/paginated
{{api_url}}/accounts/paginated?lang=es&company_id=55&sort[]=-createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=1
Content-Type: application/json
Example Response (200)
\n{\n \"data\": [\n {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"data\": {\n \"id\": 1,\n \"type\": \"account_types\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"category\": {\n \"data\": {\n \"id\": 10,\n \"type\": \"account_categories\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://localhost/api-evaluator/public/api/accounts/paginated?page=1\",\n \"last\": \"http://localhost/api-evaluator/public/api/accounts/paginated?page=1\",\n \"prev\": null,\n \"next\": null,\n \"self\": \"http://localhost/api-evaluator/public/api/accounts\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 1,\n \"per_page\": 1,\n \"total_pages\": 1\n },\n \"included\": [\n {\n \"id\": 1,\n \"type\": \"account_types\",\n \"attributes\": {\n \"name\": \"Anunciantes\",\n \"order\": 1\n },\n \"relationships\": {\n \"accounts\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/1\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n {\n \"id\": 10,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"19000\",\n \"name\": \"Viajes y Transporte\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n }\n ]\n}\n\nReturned when the token is missing or invalid.
\nExample Response (401)
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the route is incorrect or the resource is not available.
\nExample Response (404)
\n{\n \"message\": \"Not Found\"\n}\n\nReturned when an unexpected server error occurs.
\nExample Response (500)
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/accounts/paginated?lang=es&company_id=55&sort[]=-createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=1' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"es"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"47"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[text]","value":"uruguay"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[id][]","value":"274"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[country][]","value":"2"},{"disabled":true,"description":{"content":"optional | array | integer
\n","type":"text/plain"},"key":"filter[type][]","value":"2"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"filter[disabled]","value":"true"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"sort[]","value":"name"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"sort[]","value":"createdAt"},{"disabled":true,"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"country"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"type"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"logo"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"category"},{"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[size]","value":"1"},{"description":{"content":"optional | integer
\n","type":"text/plain"},"key":"page[number]","value":"2"},{"disabled":true,"key":"include[]","value":"checkDisable"},{"disabled":true,"key":"include[]","value":"checkDelete"}],"variable":[]}},"response":[{"id":"c20ee6b8-45e6-44f1-9a81-031a786d1c8d","name":"200 OK — Get advertisers paginated","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/paginated?lang=es&company_id=55&sort[]=createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=1","host":["{{api_url}}"],"path":["accounts","paginated"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"274","description":"optional | array | integer","disabled":true},{"key":"filter[country][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"sort[]","value":"name","description":"optional | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"category","description":"optional | string"},{"key":"page[size]","value":"1","description":"optional | integer"},{"key":"page[number]","value":"1","description":"optional | integer"},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:47:43 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"9a4ca458-fc94-406c-b2e1-20c56f062c24"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"data\": {\n \"id\": 1,\n \"type\": \"account_types\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"category\": {\n \"data\": {\n \"id\": 10,\n \"type\": \"account_categories\"\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://localhost/api-evaluator/public/api/accounts/paginated?page=1\",\n \"last\": \"http://localhost/api-evaluator/public/api/accounts/paginated?page=1\",\n \"prev\": null,\n \"next\": null,\n \"self\": \"http://localhost/api-evaluator/public/api/accounts\"\n },\n \"meta\": {\n \"current_page\": 1,\n \"total_items\": 1,\n \"per_page\": 1,\n \"total_pages\": 1\n },\n \"included\": [\n {\n \"id\": 1,\n \"type\": \"account_types\",\n \"attributes\": {\n \"name\": \"Anunciantes\",\n \"order\": 1\n },\n \"relationships\": {\n \"accounts\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/1\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n {\n \"id\": 10,\n \"type\": \"account_categories\",\n \"attributes\": {\n \"level\": 1,\n \"external_id\": \"19000\",\n \"name\": \"Viajes y Transporte\"\n },\n \"relationships\": {\n \"accounts\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n }\n ]\n}"},{"id":"5f0e4234-c885-4f07-bfac-fadc1eb56ede","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/paginated?lang=es&company_id=47&filter[disabled]=true&sort[]=createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=2","host":["{{api_url}}"],"path":["accounts","paginated"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"274","description":"optional | array | integer","disabled":true},{"key":"filter[country][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string"},{"key":"sort[]","value":"name","description":"optional | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"category","description":"optional | string"},{"key":"page[size]","value":"1","description":"optional | integer"},{"key":"page[number]","value":"2","description":"optional | integer"},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:41:22 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"046d7ba4-ee37-41c3-b0ce-a95e1bfe506d"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"4f20ea7f-c155-4233-b174-2a0dab756ec2","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/account/paginated?lang=es&company_id=55&sort[]=createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=10","host":["{{api_url}}"],"path":["account","paginated"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"274","description":"optional | array | integer","disabled":true},{"key":"filter[country][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"sort[]","value":"name","description":"optional | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"category","description":"optional | string"},{"key":"page[size]","value":"1","description":"optional | integer"},{"key":"page[number]","value":"10","description":"optional | integer"},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:43:37 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"d112f11c-4f2f-4ca2-a9d2-910999a2db1d","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/paginated?lang=es&company_id=55&sort[]=createdAt&include[]=type&include[]=logo&include[]=category&page[size]=1&page[number]=10","host":["{{api_url}}"],"path":["accounts","paginated"],"query":[{"key":"lang","value":"es","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"filter[text]","value":"uruguay","description":"optional | string","disabled":true},{"key":"filter[id][]","value":"274","description":"optional | array | integer","disabled":true},{"key":"filter[country][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[type][]","value":"2","description":"optional | array | integer","disabled":true},{"key":"filter[disabled]","value":"true","description":"optional | string","disabled":true},{"key":"sort[]","value":"name","description":"optional | string","disabled":true},{"key":"sort[]","value":"createdAt","description":"optional | string"},{"key":"include[]","value":"country","description":"optional | string","disabled":true},{"key":"include[]","value":"type","description":"optional | string"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"category","description":"optional | string"},{"key":"page[size]","value":"1","description":"optional | integer"},{"key":"page[number]","value":"10","description":"optional | integer"},{"key":"include[]","value":"checkDisable","disabled":true},{"key":"include[]","value":"checkDelete","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 13:44:52 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"1dbc088e-a8a2-442f-9b88-a1bf2db11a33"},{"name":"Create advertiser","id":"80c9c2d3-281b-430b-87e1-4fac040c3250","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"lang","value":"es","description":"optional | string | es,en,pt
\n","type":"text"},{"key":"company_id","value":"47","description":"required | integer
\n","type":"text"},{"key":"data[type]","value":"accounts","description":"required | string
\n","type":"text"},{"key":"data[attributes][name]","value":"McDonald's","description":"required | string
\n","type":"text"},{"key":"data[attributes][name_brand][]","value":"Sprite","description":"required | string
\n","type":"text"},{"key":"data[attributes][name_brand][]","value":"Cajita Feliz","description":"optional | string
\n","type":"text"},{"key":"data[attributes][country_id]","value":"6","description":"required | integer
\n","type":"text","disabled":true},{"key":"data[attributes][account_type_id]","value":"1","description":"required | string
\n","type":"text"},{"key":"data[attributes][logo]","description":"optional | image
\n","type":"file","src":"/C:/Users/danie/Downloads/descarga (5).png"},{"key":"data[attributes][account_category_id]","value":"4","description":"required | integer
\n","type":"text"},{"key":"data[attributes][discount_pct]","value":"85","description":"optional | integer
\n","type":"text","disabled":true},{"key":"data[attributes][company_id]","value":"47","description":"required | integer
\n","type":"text"}]},"url":"{{api_url}}/accounts","description":"Creates a new Advertiser (Account) within the specified company. Optionally, you can upload a logo and send one or multiple brand names to be associated with the advertiser.
\nUse when: you need to register a new advertiser in the system (and optionally create initial brands + logo).
\nThis endpoint requires Bearer Token authentication.
\nHeader
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: POST
URL: {{api_url}}/accounts
Content-Type: multipart/form-data (Postman: form-data)
This endpoint expects form fields (not JSON raw body), following the JSON:API-like structure data[type], data[attributes][...].
* According to your Postman setup, data[attributes][name_brand][] is marked as required. If your API truly requires at least one brand, keep it as required. Otherwise you can mark it as optional.
Content-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 474,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"McDonald's\",\n \"account_type_id\": 1,\n \"account_category_id\": 4,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"logo\": [],\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/4\"\n }\n },\n \"brand\": []\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/474\"\n }\n }\n}\n\nReturned when the token is missing/invalid.
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the advertiser does not exist (or is not visible in the provided company_id scope).
{\n \"message\": \"Not Found\"\n}\n\nReturned when required parameters are missing or invalid (body fields and/or company_id).
{\n \"message\": \"El campo data es obligatorio. (and 5 more errors)\",\n \"errors\": {\n \"data\": [\n \"El campo data es obligatorio.\"\n ],\n \"data.attributes\": [\n \"El campo data.attributes es obligatorio.\"\n ],\n \"data.attributes.name\": [\n \"El campo data.attributes.name es obligatorio.\"\n ],\n \"data.attributes.account_category_id\": [\n \"El campo data.attributes.account category id es obligatorio.\"\n ],\n \"data.attributes.name_brand\": [\n \"El campo data.attributes.name brand es obligatorio.\"\n ],\n \"data.attributes.company_id\": [\n \"El campo data.attributes.company id es obligatorio.\"\n ]\n }\n}\n\nReturned on unhandled errors.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/accounts?lang=es&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form 'data[type]=accounts' \\\n --form 'data[attributes][name]=McDonald'\\''s' \\\n --form 'data[attributes][account_type_id]=1' \\\n --form 'data[attributes][account_category_id]=4' \\\n --form 'data[attributes][company_id]=55' \\\n --form 'data[attributes][name_brand][]=Sprite' \\\n --form 'data[attributes][name_brand][]=Cajita Feliz' \\\n --form 'data[attributes][logo]=@\"/path/to/logo.png\"'\n\nRetrieves a single Advertiser (Account) by its unique identifier.
\nUse this endpoint when you need the advertiser details for a detail view, validation, or to load related data (e.g., brand/logo) for Media Plan selection.
\nThis endpoint is protected. Send:
\nAuthorization: Bearer {{token}}
Accept: application/json
(Defined in the Postman collection for the /accounts/:account request.)
Method: GET
Endpoint: {{api_url}}/accounts/:account
TDT Metrics API – PUBLIC.postma…
\n{{api_url}}/accounts/353?lang=pt&company_id=55&include[]=logo&include[]=brand
(Format matches the collection’s request contract.)
\nContent-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": {\n \"data\": [\n {\n \"id\": 317,\n \"name\": \"inDrive\",\n \"type\": \"brands\"\n }\n ]\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n}\n\nReturned when the token is missing/invalid.
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the advertiser does not exist (or is not visible in the provided company_id scope).
{\n \"message\": \"Not Found\"\n}\n\nReturned on unhandled errors.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/accounts/353?lang=pt&company_id=55&include[]=logo&include[]=brand' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}'\n\noptional | string | es,en,pt
\n","type":"text/plain"},"key":"lang","value":"pt"},{"description":{"content":"required | integer
\n","type":"text/plain"},"key":"company_id","value":"55"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"logo"},{"description":{"content":"optional | string
\n","type":"text/plain"},"key":"include[]","value":"brand"}],"variable":[{"type":"any","value":"353","key":"account"}]}},"response":[{"id":"2302bf28-e2d9-4bc6-9848-7014a1e31ac5","name":"200 OK — Get advertiser by id","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/:account?lang=pt&company_id=55&include[]=logo&include[]=brand","host":["{{api_url}}"],"path":["accounts",":account"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"brand","description":"optional | string"}],"variable":[{"key":"account","value":"353"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 14:29:09 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"3125adc8-16e3-4882-ae73-dc50a61f2074"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": {\n \"data\": [\n {\n \"id\": 317,\n \"name\": \"inDrive\",\n \"type\": \"brands\"\n }\n ]\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n}"},{"id":"791b9a79-891f-44b7-abfc-700a1bfda046","name":"401 Unauthorized — Access denied","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/:account?lang=pt&company_id=47&include[]=logo","host":["{{api_url}}"],"path":["accounts",":account"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"47","description":"required | integer"},{"key":"include[]","value":"logo"}],"variable":[{"key":"account","value":"284"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 14:27:44 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"X-Request-Id","value":"78388d38-7253-44a4-9a66-887d513f68f2"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\"\n}"},{"id":"d8bfcf91-0c7b-4e1b-94ad-7712152012bb","name":"404 Not Found — Route Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/account/:account?lang=pt&company_id=55&include[]=logo&include[]=brand","host":["{{api_url}}"],"path":["account",":account"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"brand","description":"optional | string"}],"variable":[{"key":"account","value":"353"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 14:30:42 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not Found\"\n}"},{"id":"fc3a6f58-c8ae-4299-acf0-b065b5519712","name":"500 Internal Server Error — Unexpected Failure","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{api_url}}/accounts/:account?lang=pt&company_id=55&include[]=logo&include[]=brand","host":["{{api_url}}"],"path":["accounts",":account"],"query":[{"key":"lang","value":"pt","description":"optional | string | es,en,pt"},{"key":"company_id","value":"55","description":"required | integer"},{"key":"include[]","value":"logo","description":"optional | string"},{"key":"include[]","value":"brand","description":"optional | string"}],"variable":[{"key":"account","value":"353"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 10 Feb 2026 14:31:50 GMT"},{"key":"Server","value":"Apache/2.4.62 (Win64) OpenSSL/3.1.7 PHP/8.4.0"},{"key":"Vary","value":"Authorization"},{"key":"X-Powered-By","value":"PHP/8.4.0"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}"}],"_postman_id":"4c5c024f-8d26-4c87-acf5-5f9e5e0860e9"},{"name":"Update advertiser by id","id":"89a118dc-d47d-4e4e-bd1a-b51ed3af7bf5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"lang","value":"es","description":"optional | string | es,en,pt
\n","type":"text"},{"key":"company_id","value":"55","description":"required | integer
\n","type":"text"},{"key":"_method","value":"PATCH","type":"text"},{"key":"data[type]","value":"accounts","type":"text","description":"required | string
\n"},{"key":"data[attributes][name]","value":"inDrives","type":"text","description":"required | integer
\n"},{"key":"data[attributes][logo]","type":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/emanu/Documents/TDT/Planning/accounts/remax.png"],"description":"optional | string
\n","src":"/C:/Users/emanu/Documents/TDT/Planning/accounts/remax.png","disabled":true},{"key":"data[attributes][account_category_id]","value":"10","type":"text","description":"optional | integer
\n"},{"key":"data[attributes][company_id]","value":"55","type":"text","uuid":"6661db0f-1c4a-49c9-a690-2837a499f192"}]},"url":"{{api_url}}/accounts/:account","description":"Updates an existing Advertiser (Account) using its identifier. This endpoint uses method override (_method=PATCH) and accepts multipart/form-data, allowing you to update fields and optionally upload/replace the advertiser logo.
Use when: you need to edit an advertiser name/category/logo (or other editable attributes).
\nRequires Bearer Token.
\nHeaders
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: POST
URL: {{api_url}}/accounts/:account
Path Variables
\nContent-Type: multipart/form-data
Method override: --form '_method=PATCH'
Content-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 353,\n \"type\": \"accounts\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_type_id\": 1,\n \"account_category_id\": 10,\n \"disabled\": false,\n \"company_id\": 55,\n \"country_id\": null,\n \"website\": null,\n \"linkedin\": null,\n \"parent\": null,\n \"operator_code\": null\n },\n \"meta\": {\n \"can_be_disabled\": null,\n \"can_be_deleted\": null\n },\n \"relationships\": {\n \"type\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-types/1\"\n }\n },\n \"category\": {\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/account-categories/10\"\n }\n },\n \"brand\": {\n \"data\": [\n {\n \"id\": 317,\n \"name\": \"inDrive\",\n \"type\": \"brands\"\n }\n ]\n }\n },\n \"links\": {\n \"self\": \"http://localhost/api-evaluator/public/api/accounts/353\"\n }\n }\n}\n\nReturned when the token is missing/invalid.
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the advertiser does not exist (or is not visible in the provided company_id scope).
{\n \"message\": \"Not Found\"\n}\n\nReturned when required parameters are missing or invalid (body fields and/or company_id).
{\n \"message\": \"El campo data es obligatorio. (and 5 more errors)\",\n \"errors\": {\n \"data\": [\n \"El campo data es obligatorio.\"\n ],\n \"data.attributes\": [\n \"El campo data.attributes es obligatorio.\"\n ],\n \"data.attributes.name\": [\n \"El campo data.attributes.name es obligatorio.\"\n ],\n \"data.attributes.account_category_id\": [\n \"El campo data.attributes.account category id es obligatorio.\"\n ],\n \"data.attributes.name_brand\": [\n \"El campo data.attributes.name brand es obligatorio.\"\n ],\n \"data.attributes.company_id\": [\n \"El campo data.attributes.company id es obligatorio.\"\n ]\n }\n}\n\nReturned on unhandled errors.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/accounts/353?lang=es&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form '_method=PATCH' \\\n --form 'data[type]=accounts' \\\n --form 'data[attributes][name]=inDrive' \\\n --form 'data[attributes][account_category_id]=10' \\\n --form 'data[attributes][company_id]=55' \\\n --form 'data[attributes][logo]=@\"/path/to/inDrive.png\"'\n\noptional | string | es,en,pt
\n","type":"text"},{"key":"company_id","value":"55","description":"required | integer
\n","type":"text"},{"key":"_method","value":"PATCH","type":"text"},{"key":"data[account_id]","value":"353","type":"text","description":"required | integer
\n"},{"key":"data[type]","value":"brands","type":"text","description":"required | string
\n"},{"key":"data[attributes][name]","value":"inDrive","type":"text","description":"required | string
\n"},{"key":"data[attributes][brand_id]","value":"317","type":"text","description":"required | integer
\n"}]},"url":"{{api_url}}/brands/:account","description":"Updates an existing Brand that belongs to a specific Advertiser (Account). This endpoint uses method override (_method=PATCH) and accepts multipart/form-data.
Use when: you need to rename a brand (or update brand fields) for a given advertiser.
\nRequires Bearer Token.
\nHeaders
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: POST
URL: {{api_url}}/brands/:account
:account is the advertiser (account) identifier used as context for the update.
Content-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n}\n\nReturned when the token is missing/invalid.
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the advertiser does not exist (or is not visible in the provided company_id scope).
{\n \"message\": \"Not Found\"\n}\n\nReturned when required parameters are missing or invalid (body fields and/or company_id).
{\n \"message\": \"El campo data es obligatorio. (and 5 more errors)\",\n \"errors\": {\n \"data\": [\n \"El campo data es obligatorio.\"\n ],\n \"data.account_id\": [\n \"El campo data.account id es obligatorio.\"\n ],\n \"data.type\": [\n \"El campo data.type es obligatorio.\"\n ],\n \"data.attributes\": [\n \"El campo data.attributes es obligatorio.\"\n ],\n \"data.attributes.name\": [\n \"El campo data.attributes.name es obligatorio.\"\n ],\n \"data.attributes.brand_id\": [\n \"El campo data.attributes.brand id es obligatorio.\"\n ]\n }\n}\n\nReturned on unhandled errors.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/brands/353?lang=es&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form '_method=PATCH' \\\n --form 'data[account_id]=353' \\\n --form 'data[type]=brands' \\\n --form 'data[attributes][name]=inDrive' \\\n --form 'data[attributes][brand_id]=317'\n\noptional | string | es,en,pt
\n","type":"text"},{"key":"company_id","value":"55","description":"required | integer
\n","type":"text"},{"key":"data[account_id]","value":"352","type":"text"},{"key":"data[type]","value":"brands","type":"text"},{"key":"data[attributes][name]","value":"brand Indrive","type":"text"}]},"url":"{{api_url}}/brands/:account","description":"Creates a new Brand under an existing Advertiser (Account). The request is sent as multipart/form-data and returns the created brand resource.
\nUse when: you need to add one or more brands for an advertiser (e.g., advertiser has multiple brands).
\nRequires Bearer Token.
\nHeaders
\nAuthorization: Bearer {{token}}
Accept: application/json
Method: POST
URL: {{api_url}}/brands/:account
:account is the advertiser (account) context for creating the brand.
Content-Type: application/json
Example Response (200)
\n{\n \"data\": {\n \"id\": 317,\n \"type\": \"brands\",\n \"attributes\": {\n \"name\": \"inDrive\",\n \"account_id\": 353\n }\n }\n}\n\nReturned when the token is missing/invalid.
\n{\n \"message\": \"Unauthorized\"\n}\n\nReturned when the advertiser does not exist (or is not visible in the provided company_id scope).
{\n \"message\": \"Not Found\"\n}\n\nReturned when required parameters are missing or invalid (body fields and/or company_id).
{\n \"message\": \"El campo data es obligatorio. (and 4 more errors)\",\n \"errors\": {\n \"data\": [\n \"El campo data es obligatorio.\"\n ],\n \"data.account_id\": [\n \"El campo data.account id es obligatorio.\"\n ],\n \"data.type\": [\n \"El campo data.type es obligatorio.\"\n ],\n \"data.attributes\": [\n \"El campo data.attributes es obligatorio.\"\n ],\n \"data.attributes.name\": [\n \"El campo data.attributes.name es obligatorio.\"\n ]\n }\n}\n\nReturned on unhandled errors.
\n{\n \"message\": \"An unexpected error occurred. Please try again later.\"\n}\n\ncurl --location '{{api_url}}/brands/353?lang=es&company_id=55' \\\n --header 'Accept: application/json' \\\n --header 'Authorization: Bearer {{token}}' \\\n --form 'data[account_id]=353' \\\n --form 'data[type]=brands' \\\n --form 'data[attributes][name]=brand Indrive'\n\nAdvertisers represent the Advertiser/Brand entities used across the platform (e.g., for Media Plans, reporting, and account management).
This folder provides a complete set of endpoints to list, create, update, and manage advertisers and their associated brands, including pagination and lifecycle actions (enable/disable/delete).
GET — Get all advertiser
Returns the full list of advertisers accessible to the authenticated user/company context.
Use when: you need to populate dropdowns/selectors or fetch the full catalog (small/medium datasets).
GET — Get all brands by advertiser
Returns all brands that belong to a specific advertiser.
Use when: you have an advertiser_id and need its brands for selection or validation.
GET — Get advertisers paginated
Returns a paginated list of advertisers with optional filters/sorting (depending on your implementation).
Use when: you need dashboards, search results, large datasets, or filtering/sorting in UI.
POST — Create advertiser
Creates a new advertiser (and optionally related data depending on your API).
Use when: onboarding a new advertiser into the platform.
GET — Get advertiser by id
Retrieves a single advertiser resource by its unique identifier.
Use when: opening a detail view or validating that the advertiser exists.
POST — Update advertiser by id
Updates advertiser information (name, category, metadata, status, etc. depending on your API).
Use when: editing advertiser details from an admin panel or integration.
POST — Update brand by id advertiser
Updates a brand that belongs to a specific advertiser.
Use when: editing brand details while keeping it scoped to its advertiser.
POST — Create brand by id advertiser
Creates a new brand under a given advertiser.
Use when: the advertiser needs additional brands to manage campaigns/media plans.
Base URL: {{api_url}}
Default header: Accept: application/json
Protected endpoints require:
\nAuthorization: Bearer {{token}}These endpoints typically use:
\n200 success
\n401 unauthorized (missing/invalid token)
\n403 forbidden (insufficient permissions)
\n404 not found (resource not available)
\n422 validation error (missing/invalid fields)
\n500 unexpected server error
\nThis module is used to manage advertiser information. An advertiser is required when creating a Media Plan or Media Insights.
\nUse these endpoints to:
\nList all advertisers (full list or paginated)
\nRetrieve a single advertiser by ID
\nCreate / update / delete advertisers
\nManage brands for a given advertiser (list, create, update, delete)
\nEnable or disable an advertiser without deleting it
\nAll endpoints in this folder are protected.
\nSend the following header on every request:
\nAuthorization: Bearer {{token}}
Accept: application/json
Tokens are obtained via the authentication endpoints (Keycloak proxy).
\nAdvertiser = Account (same concept across the API).
\nBrand is a child entity linked to an Advertiser (Account).
\nSome requests may use multipart/form-data fields and/or nested formats like data[attributes]
Advertisers (Accounts)
\nGET Get all advertisers
GET Get advertisers paginated
GET Get advertiser by id
POST Create advertiser
POST Update advertiser by id
DEL Delete advertiser by id
POST Disable advertiser by id
POST Enable advertiser by id
Brands
\nGET Get all brands by advertiser
POST Create brand by id advertiser
POST Update brand by id advertiser
DEL Delete brand by id
These endpoints follow the standard error format used across the public API contract:
\n401 Unauthorized — Missing/invalid token
\n404 Not Found — Resource does not exist
\n422 Unprocessable Entity — Validation errors
\n500 Internal Server Error — Unexpected failure
\n