Trimble

Trimble Regions API

Regions discovery

GitHub OpenAPI

Operations 2

GET /2.1/regions Get Available Regions (v2.1) #
GET /regions Get Available Regions #

Documentation

📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/core/v2
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/core
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/issues
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/model
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/model-feature
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/organizer
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/property-set
📖
Documentation
https://developer.trimble.com/docs/connect/reference/openapi/topics
📖
Documentation
https://developer.trimble.com/docs/mobile-manager/reference/openapi/v1/
📖
Documentation
https://developer.trimble.com/docs/tmt/reference/openapi/v1/
📖
Documentation
https://developer.trimble.com/docs/truckmate/reference/openapi/truckmate
📖
Documentation
https://developer.trimble.com/docs/truckmate/reference/openapi/finance
📖
Documentation
https://developer.trimble.com/docs/truckmate/reference/openapi/master-data
📖
Documentation
https://direct-api.xchange.trimble.com/reference

Specifications

⚙
OpenAPI
https://artifacts.apis.io/trimble/openapi/trimble-regions-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/trimble/json-schema/trimble-get-available-regions-response-schema.json

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/trimble:trimble-regions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

trimble-regions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Trimble Regions API
  contact:
    name: Trimble Connect Support
    url: https://connect.trimble.com
    email: connect-support@trimble.com
  license:
    name: Trimble Connect SDK Internal Use License
    url: https://developer.trimble.com/docs/connect/terms/SDK-IU-license-agreement
  termsOfService: https://developer.trimble.com/docs/connect/terms
  version: '1.0'
  description: 'Operations tagged Regions across 2 of this provider''s published API definitions: trimble-connect-core-openapi.json, trimble-connect-core-v2-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.connect.trimble.com/tc/api/2.0
  description: PROD US master region
- url: https://app21.connect.trimble.com/tc/api/2.0
  description: PROD EU region
- url: https://app22.connect.trimble.com/tc/api/2.0
  description: PROD UK region
- url: https://app31.connect.trimble.com/tc/api/2.0
  description: PROD AP region
- url: https://app32.connect.trimble.com/tc/api/2.0
  description: PROD AP2 region
- url: https://app.stage.connect.trimble.com/tc/api/2.0
  description: STAGE US master region
- url: https://app31.stage.connect.trimble.com/tc/api/2.0
  description: STAGE AP region
- url: https://app21.stage.connect.trimble.com/tc/api/2.0
  description: STAGE EU region
- url: https://app.connect.trimble.com/tc/api
  description: PROD US master region (v2.1)
- url: https://app21.connect.trimble.com/tc/api
  description: PROD EU region (v2.1)
- url: https://app22.connect.trimble.com/tc/api
  description: PROD UK region (v2.1)
- url: https://app31.connect.trimble.com/tc/api
  description: PROD AP region (v2.1)
- url: https://app32.connect.trimble.com/tc/api
  description: PROD AP2 region (v2.1)
- url: https://app.stage.connect.trimble.com/tc/api
  description: STAGE US master region (v2.1)
- url: https://app31.stage.connect.trimble.com/tc/api
  description: STAGE AP region (v2.1)
- url: https://app21.stage.connect.trimble.com/tc/api
  description: STAGE EU region (v2.1)
- url: https://us-east.api.trimble.com/connect/v2
  description: Prod US
- url: https://eu.api.trimble.com/connect/v2
  description: Prod EU
- url: https://ap-au.api.trimble.com/connect/v2
  description: Prod AP2
- url: https://ap-sg.api.trimble.com/connect/v2
  description: Prod AP1
- url: https://eu-gb.api.trimble.com/connect/v2
  description: Prod UK
tags:
- name: Regions
  description: Regions discovery
paths:
  /2.1/regions:
    get:
      tags:
      - Regions
      summary: Get Available Regions (v2.1)
      description: 'Get Available Regions.


        The `availability` query parameter selects which regions are returned.

        When it is omitted, only `ga` regions are returned.

        Use `availability=preview` for preview regions only, or `availability=ga,preview` to include both.'
      operationId: GetAvailableRegionsV21
      security: []
      parameters:
      - name: availability
        in: query
        required: false
        description: 'Comma-separated availability values to include.


          **Default:** `ga`


          **Supported values:** `ga`, `preview`


          **Examples:** `ga`, `preview`, `ga,preview`

          '
        schema:
          type: string
          default: ga
          example: ga,preview
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GetAvailableRegionsV21Response'
        '400':
          description: Bad Request - Invalid availability query parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseV21'
              examples:
                unknown_availability:
                  summary: Unknown availability value
                  value:
                    error: INVALID_PARAM
                    message: 'Unsupported availability value: beta'
                repeated_availability_param:
                  summary: Repeated availability query parameter
                  value:
                    error: INVALID_PARAM
                    message: availability must appear at most once; use comma-separated values (e.g. ga,preview)
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseV21'
              examples:
                regions_config_missing:
                  summary: Regions static URL not configured
                  value:
                    error: REGIONS_CONFIG_MISSING
                    message: Regions configuration is missing
                regions_response_invalid:
                  summary: Filtered regions payload is invalid
                  value:
                    error: REGIONS_RESPONSE_INVALID
                    message: Failed to process regions response
        '502':
          description: Bad Gateway - Upstream regions origin returned a non-success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseV21'
              examples:
                origin_non_success:
                  summary: Upstream HTTP non-success or invalid upstream JSON
                  value:
                    error: REGIONS_ORIGIN_BAD_GATEWAY
                    message: Failed to get regions response from S3
        '503':
          description: Service Unavailable - Upstream regions origin unreachable or temporarily backed off
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseV21'
              examples:
                origin_unavailable:
                  summary: Upstream unreachable or origin fetch backed off
                  value:
                    error: REGIONS_ORIGIN_UNAVAILABLE
                    message: Failed to get regions response from S3
    servers:
    - url: https://app.connect.trimble.com/tc/api/2.0
      description: PROD US master region
    - url: https://app21.connect.trimble.com/tc/api/2.0
      description: PROD EU region
    - url: https://app22.connect.trimble.com/tc/api/2.0
      description: PROD UK region
    - url: https://app31.connect.trimble.com/tc/api/2.0
      description: PROD AP region
    - url: https://app32.connect.trimble.com/tc/api/2.0
      description: PROD AP2 region
    - url: https://app.stage.connect.trimble.com/tc/api/2.0
      description: STAGE US master region
    - url: https://app31.stage.connect.trimble.com/tc/api/2.0
      description: STAGE AP region
    - url: https://app21.stage.connect.trimble.com/tc/api/2.0
      description: STAGE EU region
    - url: https://app.connect.trimble.com/tc/api
      description: PROD US master region (v2.1)
    - url: https://app21.connect.trimble.com/tc/api
      description: PROD EU region (v2.1)
    - url: https://app22.connect.trimble.com/tc/api
      description: PROD UK region (v2.1)
    - url: https://app31.connect.trimble.com/tc/api
      description: PROD AP region (v2.1)
    - url: https://app32.connect.trimble.com/tc/api
      description: PROD AP2 region (v2.1)
    - url: https://app.stage.connect.trimble.com/tc/api
      description: STAGE US master region (v2.1)
    - url: https://app31.stage.connect.trimble.com/tc/api
      description: STAGE AP region (v2.1)
    - url: https://app21.stage.connect.trimble.com/tc/api
      description: STAGE EU region (v2.1)
  /regions:
    get:
      tags:
      - Regions
      summary: Get Available Regions
      operationId: GetAvailableRegions
      parameters: []
      security: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GetAvailableRegionsResponse'
    servers:
    - url: https://app.connect.trimble.com/tc/api/2.0
      description: PROD US master region
    - url: https://app21.connect.trimble.com/tc/api/2.0
      description: PROD EU region
    - url: https://app22.connect.trimble.com/tc/api/2.0
      description: PROD UK region
    - url: https://app31.connect.trimble.com/tc/api/2.0
      description: PROD AP region
    - url: https://app32.connect.trimble.com/tc/api/2.0
      description: PROD AP2 region
    - url: https://app.stage.connect.trimble.com/tc/api/2.0
      description: STAGE US master region
    - url: https://app31.stage.connect.trimble.com/tc/api/2.0
      description: STAGE AP region
    - url: https://app21.stage.connect.trimble.com/tc/api/2.0
      description: STAGE EU region
    - url: https://app.connect.trimble.com/tc/api
      description: PROD US master region (v2.1)
    - url: https://app21.connect.trimble.com/tc/api
      description: PROD EU region (v2.1)
    - url: https://app22.connect.trimble.com/tc/api
      description: PROD UK region (v2.1)
    - url: https://app31.connect.trimble.com/tc/api
      description: PROD AP region (v2.1)
    - url: https://app32.connect.trimble.com/tc/api
      description: PROD AP2 region (v2.1)
    - url: https://app.stage.connect.trimble.com/tc/api
      description: STAGE US master region (v2.1)
    - url: https://app31.stage.connect.trimble.com/tc/api
      description: STAGE AP region (v2.1)
    - url: https://app21.stage.connect.trimble.com/tc/api
      description: STAGE EU region (v2.1)
components:
  schemas:
    ErrorResponseV21:
      type: object
      title: ErrorResponseV21
      description: Standard error response format
      required:
      - error
      - message
      properties:
        error:
          type: string
          description: Error code indicating the type of error
          example: INVALID_ARGUMENTS
          enum:
          - INVALID_ARGUMENTS
          - UNAUTHORIZED
          - INTERNAL_ERROR
          - NOT_FOUND
        message:
          type: string
          description: Human-readable error message providing details about the error
          example: 'Invalid field: license.invalidField. Valid fields are: [license.appAccess, license.policyType, description]'
      example:
        error: INVALID_ARGUMENTS
        message: PageSize must be a positive integer between 1 and 500
    GetAvailableRegionsResponse:
      title: GetAvailableRegionsResponse
      required:
      - isMaster
      - origin
      - location
      - serviceRegion
      - trnRegion
      - awsRegion
      - region
      - map-bbox
      - tc-api
      - objects-sync-api
      - org-api
      - pset-api
      - projects-api
      - wopi-api
      - batch-api
      - user-api
      - issues-api
      - model-api
      - topic-api
      type: object
      properties:
        isMaster:
          type: boolean
          description: Indicates if the region is the Master Region
        origin:
          type: string
          description: The Origin of the region
        location:
          type: string
          description: The Location of the region
        serviceRegion:
          type: string
          description: The Service Region Code for the region
        trnRegion:
          type: string
          description: The region segment used in TRN resource identifiers (e.g. Issue contextId TRN)
          enum:
          - us
          - eu
          - ap
          - ap-au
          - eu-gb
        awsRegion:
          type: string
          description: The AWS Region code for the region
        region:
          type: string
          description: The Region code for the region, maps to the region in TRN (e.g. Issue contextId TRN)
          enum:
          - us
          - eu
          - ap
          - ap-au
          - eu-gb
        map-bbox:
          type: array
          items:
            type: number
          description: Lat, long bounding box for the region's map in [west, south, east, north] format.
        tc-api:
          type: string
          description: The base URL of TC APIs for the region
        objects-sync-api:
          type: string
          description: (Connect Internal) The base URL of Objects Sync APIs for the region
        org-api:
          type: string
          description: The base URL of Organizer Service APIs for the region
        pset-api:
          type: string
          description: The base URL of PSet Service APIs for the region
        projects-api:
          type: string
          description: (Connect Internal) The base URL of Projects Service APIs for the region
        wopi-api:
          type: string
          description: (Connect Internal) The base URL of WOPI Service APIs for the region
        batch-api:
          type: string
          description: (Connect Internal) The base URL of Batch Service APIs for the region
        user-api:
          type: string
          description: (Connect Internal) The base URL of User Service APIs for the region
        issues-api:
          type: string
          description: The base URL of Issue Management APIs for the region
        connect-api:
          type: string
          description: The base URL of Connect APIs for the region. Clients append /v2 to this endpoint.
        cde-connector-api:
          type: string
          description: The base URL of CDE Connector APIs for the region
        model-api:
          type: string
          description: The base URL of Model Service APIs for the region
        topic-api:
          type: string
          description: The base URL of Topics Service APIs for the region
        model-feature-api:
          type: string
          description: The base URL of Model Feature Service APIs for the region
      example:
      - isMaster: true
        origin: //{baseUrl}
        location: northAmerica
        serviceRegion: na
        trnRegion: us
        awsRegion: us-east-1
        map-bbox:
        - -114.2871
        - 29.5313
        - -80.8298
        - 49.9512
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        connect-api: https://{connect-api-baseUrl}
        cde-connector-api: https://{cde-connector-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
      - isMaster: false
        origin: //{baseUrl}
        location: europe
        serviceRegion: eu
        trnRegion: eu
        awsRegion: eu-west-1
        map-bbox:
        - -7.0313
        - 42.0329
        - 27.2461
        - 53.4302
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        connect-api: https://{connect-api-baseUrl}
        cde-connector-api: https://{cde-connector-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
    GetAvailableRegionsV21Response:
      title: GetAvailableRegionsV21Response
      required:
      - location
      - region
      - availability
      type: object
      properties:
        location:
          type: string
          description: The Location of the region
        region:
          type: string
          description: The Region code for the region
          enum:
          - us
          - eu
          - ap
          - ap-au
          - eu-gb
        availability:
          type: string
          description: Region availability. Omitted values are treated as ga.
          enum:
          - ga
          - preview
        tc-api:
          type: string
          description: The base URL of TC APIs for the region
        objects-sync-api:
          type: string
          description: The base URL of Objects Sync APIs for the region
        org-api:
          type: string
          description: The base URL of Organizer Service APIs for the region
        pset-api:
          type: string
          description: The base URL of PSet Service APIs for the region
        projects-api:
          type: string
          description: The base URL of Projects Service APIs for the region
        wopi-api:
          type: string
          description: The base URL of WOPI Service APIs for the region
        batch-api:
          type: string
          description: The base URL of Batch Service APIs for the region
        user-api:
          type: string
          description: The base URL of User Service APIs for the region
        issues-api:
          type: string
          description: The base URL of Issue Management APIs for the region
        model-api:
          type: string
          description: The base URL of Model Service APIs for the region
        topic-api:
          type: string
          description: The base URL of Topics Service APIs for the region
        model-feature-api:
          type: string
          description: The base URL of Model Feature Service APIs for the region
      example:
      - location: northAmerica
        region: us
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
        availability: ga
      - location: europe
        region: eu
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
        availability: ga
    GetAvailableRegionsResponse_2:
      title: GetAvailableRegionsResponse
      required:
      - isMaster
      - origin
      - location
      - serviceRegion
      - trnRegion
      - awsRegion
      - region
      - map-bbox
      - tc-api
      - objects-sync-api
      - org-api
      - pset-api
      - projects-api
      - wopi-api
      - batch-api
      - user-api
      - issues-api
      - model-api
      - topic-api
      type: object
      properties:
        isMaster:
          type: boolean
          description: Indicates if the region is the Master Region
        origin:
          type: string
          description: The Origin of the region
        location:
          type: string
          description: The Location of the region
        serviceRegion:
          type: string
          description: The Service Region Code for the region
        trnRegion:
          type: string
          description: The region segment used in TRN resource identifiers (e.g. Issue contextId TRN)
          enum:
          - us
          - eu
          - ap
          - ap-au
          - eu-gb
        awsRegion:
          type: string
          description: The AWS Region code for the region
        region:
          type: string
          description: The Region code for the region, maps to the region in TRN (e.g. Issue contextId TRN)
          enum:
          - us
          - eu
          - ap
          - ap-au
          - eu-gb
        map-bbox:
          type: array
          items:
            type: number
          description: Lat, long bounding box for the region's map in [west, south, east, north] format.
        tc-api:
          type: string
          description: The base URL of TC APIs for the region
        objects-sync-api:
          type: string
          description: (Connect Internal) The base URL of Objects Sync APIs for the region
        org-api:
          type: string
          description: The base URL of Organizer Service APIs for the region
        pset-api:
          type: string
          description: The base URL of PSet Service APIs for the region
        projects-api:
          type: string
          description: (Connect Internal) The base URL of Projects Service APIs for the region
        wopi-api:
          type: string
          description: (Connect Internal) The base URL of WOPI Service APIs for the region
        batch-api:
          type: string
          description: (Connect Internal) The base URL of Batch Service APIs for the region
        user-api:
          type: string
          description: (Connect Internal) The base URL of User Service APIs for the region
        issues-api:
          type: string
          description: The base URL of Issue Management APIs for the region
        model-api:
          type: string
          description: The base URL of Model Service APIs for the region
        topic-api:
          type: string
          description: The base URL of Topics Service APIs for the region
        model-feature-api:
          type: string
          description: The base URL of Model Feature Service APIs for the region
      example:
      - isMaster: true
        origin: //{baseUrl}
        location: northAmerica
        serviceRegion: na
        trnRegion: us
        awsRegion: us-east-1
        map-bbox:
        - -114.2871
        - 29.5313
        - -80.8298
        - 49.9512
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
      - isMaster: false
        origin: //{baseUrl}
        location: europe
        serviceRegion: eu
        trnRegion: eu
        awsRegion: eu-west-1
        map-bbox:
        - -7.0313
        - 42.0329
        - 27.2461
        - 53.4302
        tc-api: https://{tc-baseUrl}
        objects-sync-api: https://{sync-api-baseUrl}
        org-api: https://{org-api-baseUrl}
        pset-api: https://{pset-api-baseUrl}
        projects-api: https://{projects-api-baseUrl}
        wopi-api: https://{wopi-api-baseUrl}
        batch-api: https://{batch-api-baseUrl}
        user-api: https://{user-api-baseUrl}
        issues-api: https://{issues-api-baseUrl}
        model-api: https://{model-api-baseUrl}
        topic-api: https://{topic-api-baseUrl}
        model-feature-api: https://{model-feature-api-baseUrl}
  securitySchemes:
    Bearer:
      type: http
      description: The Trimble ID access token.
      scheme: bearer
      bearerFormat: JWT
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Trimble Identity (Trimble ID) JWT access token.
x-refined-from:
- trimble-connect-core-openapi.json
- trimble-connect-core-v2-openapi.yaml