osrmroute-com Place details API

The Place details API from osrmroute-com — 1 operation(s) for place details.

Operations 1

POST /api/v1/places/details Read source place attributes #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/osrmroute-com:osrmroute-com-place-details-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

osrmroute-com-place-details-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OSRMRoute Place details API
  version: 1.1.0
  description: 'OSRMRoute — Maps, Routing, Truck Routing, Search, Road Data, Studio and integration APIs. Use `Authorization: Bearer ` unless an operation documents another flow. Legacy APIs also accept the key query parameter; New geospatial APIs, MCP and private map delivery require Bearer authentication. Mobile challenge/token endpoints use device attestation instead. Coordinates and units are documented per operation: GeoJSON uses longitude,latitude; some legacy and background-job inputs use latitude,longitude. Examples are illustrative, not guaranteed current results. Guides · Mobile Access · MCP · Postman collection.'
  contact:
    name: OSRMRoute Support
    url: https://osrmroute.com/contact
    email: support@osrmroute.com
  termsOfService: https://osrmroute.com/terms
servers:
- url: https://osrmroute.com
security:
- bearerAuth: []
- apiKeyQuery: []
tags:
- name: Place details
paths:
  /api/v1/places/details:
    post:
      tags:
      - Place details
      operationId: placeDetails
      summary: Read source place attributes
      description: Places scope; one credit. Read one OpenStreetMap object by its search result ID. Source object cached for one hour. Body limit 1 KiB. Missing attributes and open_now remain null. Source timestamp reflects the OSM object edit, not independent business verification. Twenty calls per minute per key; source cache misses share a global thirty-per-minute limit. Failed lookups are refunded.
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                id:
                  type: string
                  maxLength: 24
                  description: osm:N:123, osm:W:123 or osm:R:123 from a search result
              required:
              - id
            examples:
              request:
                value:
                  id: osm:N:123
      responses:
        '200':
          description: Success. Examples are illustrative; results vary with input and source data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  place:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type:
                        - string
                        - 'null'
                      details:
                        type: object
                        properties:
                          phone:
                            type:
                            - string
                            - 'null'
                          website:
                            type:
                            - string
                            - 'null'
                            format: uri
                          opening_hours:
                            type:
                            - string
                            - 'null'
                          wheelchair:
                            type:
                            - string
                            - 'null'
                            enum:
                            - 'yes'
                            - 'no'
                            - limited
                            - designated
                            - null
                          source:
                            type: string
                            enum:
                            - openstreetmap
                          license:
                            type: string
                            enum:
                            - ODbL-1.0
                          observed_at:
                            type: string
                            format: date-time
                          source_updated_at:
                            type:
                            - string
                            - 'null'
                            format: date-time
                          open_now:
                            type:
                            - boolean
                            - 'null'
                            description: Always null; opening hours are not evaluated.
                        required:
                        - phone
                        - website
                        - opening_hours
                        - wheelchair
                        - source
                        - license
                        - observed_at
                        - source_updated_at
                        - open_now
                      source_url:
                        type: string
                        format: uri
                    required:
                    - id
                    - name
                    - details
                    - source_url
                  retrieval:
                    type: string
                    enum:
                    - source_object_with_one_hour_cache
                required:
                - place
                - retrieval
              example:
                place:
                  id: osm:N:123
                  name: Example place
                  details:
                    phone: null
                    website: null
                    opening_hours: null
                    wheelchair: null
                    source: openstreetmap
                    license: ODbL-1.0
                    observed_at: '2026-10-19T00:00:00Z'
                    source_updated_at: null
                    open_now: null
                  source_url: https://www.openstreetmap.org/node/123
                retrieval: source_object_with_one_hour_cache
        '400':
          description: Invalid input. `invalid_place_id` Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
              example:
                error: invalid_place_id
                code: invalid_place_id
                problem_code: invalid_place_id
                type: https://osrmroute.com/docs/platform#invalid_place_id
                title: Request failed
                status: 400
                detail: invalid_place_id
                instance: urn:uuid:00000000-0000-4000-8000-000000000001
                request_id: 00000000-0000-4000-8000-000000000001
                retryable: false
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid authentication. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Insufficient credits. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '403':
          description: Scope, account or plan restriction. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '404':
          description: Resource not found. `place_not_found` Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
              example:
                error: place_not_found
                code: place_not_found
                problem_code: place_not_found
                type: https://osrmroute.com/docs/platform#place_not_found
                title: Request failed
                status: 404
                detail: place_not_found
                instance: urn:uuid:00000000-0000-4000-8000-000000000001
                request_id: 00000000-0000-4000-8000-000000000001
                retryable: false
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '413':
          description: Payload too large. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '422':
          description: Request cannot be fulfilled. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate, quota or concurrency limit. See the returned error code. Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '502':
          description: Invalid or unavailable upstream. `invalid_place_response` Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
              example:
                error: invalid_place_response
                code: invalid_place_response
                problem_code: invalid_place_response
                type: https://osrmroute.com/docs/platform#invalid_place_response
                title: Service unavailable
                status: 502
                detail: invalid_place_response
                instance: urn:uuid:00000000-0000-4000-8000-000000000001
                request_id: 00000000-0000-4000-8000-000000000001
                retryable: true
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '503':
          description: Service temporarily unavailable. `place_source_busy` Failed operations are not charged.
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                  problem_code:
                    type: string
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    minimum: 0
                  detail:
                    type: string
                  instance:
                    type: string
                  request_id:
                    type: string
                    format: uuid
                  retryable:
                    type: boolean
                required:
                - error
                - code
                - problem_code
                - type
                - title
                - status
                - detail
                - instance
                - request_id
                - retryable
              example:
                error: place_source_busy
                code: place_source_busy
                problem_code: place_source_busy
                type: https://osrmroute.com/docs/platform#place_source_busy
                title: Service unavailable
                status: 503
                detail: place_source_busy
                instance: urn:uuid:00000000-0000-4000-8000-000000000001
                request_id: 00000000-0000-4000-8000-000000000001
                retryable: true
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
components:
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      in: query
      name: key
    bearerAuth:
      type: http
      scheme: bearer