> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sorce.jobs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search locations

> Canonical place autocomplete. Job locations must reference a suggestion's `locationId`. Free-typed places are rejected.




## OpenAPI

````yaml /openapi.yaml get /locations/search
openapi: 3.1.0
info:
  title: Sorce API
  version: '1.0'
  description: >
    Programmatic job management for partners on Sorce. Authenticate with a
    company-bound partner key. All endpoints are served from
    https://www.sorce.jobs/api/external/v1.
servers:
  - url: https://www.sorce.jobs/api/external/v1
security:
  - bearerAuth: []
tags:
  - name: Locations
    description: Canonical place lookup. Search first, reference by id.
  - name: Jobs
    description: >
      Partner job management. Requires a partner key bound to your company.
      Other companies' jobs 404.
paths:
  /locations/search:
    get:
      tags:
        - Locations
      summary: Search locations
      description: >
        Canonical place autocomplete. Job locations must reference a
        suggestion's `locationId`. Free-typed places are rejected.
      operationId: searchLocations
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
          example: San Francisco
        - name: country
          in: query
          required: false
          schema:
            type: string
            default: United States
      responses:
        '200':
          description: Matching places, best first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/LocationSuggestion'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    LocationSuggestion:
      type: object
      properties:
        locationId:
          type: integer
          example: 17024
        displayName:
          type: string
          example: San Francisco, California, United States
        city:
          type: string
          example: San Francisco
        stateProvince:
          type: string
          example: California
        country:
          type: string
          example: United States
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            fields:
              type: object
              additionalProperties:
                type: string
          required:
            - code
            - message
  responses:
    Unauthorized:
      description: Missing, unknown, or revoked partner key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INVALID_SERVICE_KEY
              message: Invalid service key.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Partner key (`sk_ext_…`) bound to your company.

````