HomeDocumentationAPI Reference
API Reference

Get Market Collection With External IDs

post
https://api.mira.co/geo/markets/external-ids/

Retrieve a collection of Markets based on supplied IDs. These IDs correspond to externally provided IDs, such as Nielsen DMA IDs, US Postal Code Strings, etc, rather than internal Mira integers.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
paginate
object
Defaults to [object Object]

Pagination parameters. All-None means 'return everything'.

Named 'Paginate' (not 'PaginationParams') because this single model
is used for both GET query params and POST body fields — keeping one
name avoids the GET/POST semantic split. 'Pagination' was taken by
the response model.

Business defaults (this layer):

  • page without per_page: per_page defaults to PAGE_SIZE
  • per_page without page: page defaults to 0

Correctness guards (mira-lib-python fetch_paginated):

  • per_page < 1: raises ValueError
  • page < 0: raises ValueError
  • asymmetric page/per_page: raises ValueError

Entry points:

  • GET: resolve_paginate() dependency (paginate=false -> all-None)
  • POST: PaginatedRequest field_validator (paginate: null -> all-None)
ids
array of integers
required
Ids*
Response

Updated 21 days ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 21 days ago