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

# Get apilocationslevel2

> ViewSet for Level2 locations (counties/departments) with filtering support.

Query parameters:
- states: State IDs (repeated parameter format, e.g., 'states=46&states=44&states=51')
- country: Country alpha2 code (e.g., 'AU', 'FR')

Example: /api/locations/level2/?states=46&states=44&states=51&country=AU



## OpenAPI

````yaml /api-reference/openapi.json get /api/locations/level2/
openapi: 3.0.3
info:
  title: SphereScout API
  version: 1.0.0
  description: >

    # SphereScout API


    SphereScout provides B2B lead data — business contacts with emails,

    phone numbers, and location metadata — across multiple countries.


    ## Authentication


    All endpoints (except `/api/auth/` and `/api/plans`) require a **JWT Bearer
    token**.


    1. **Register** — `POST /api/auth/sign-up/`

    2. **Login** — `POST /api/auth/login/` → returns `access` and `refresh`
    tokens

    3. **Attach header** — `Authorization: Bearer <access_token>`

    4. **Refresh** — `POST /api/token/refresh/` with `{ "refresh": "<token>" }`


    Access tokens expire after 60 minutes. Refresh tokens are long-lived.


    ## Credits


    Every account has a credit balance. Exporting leads costs **1 credit per
    lead**.

    Check your balance via `GET /api/user/profile/`. Credits reset each billing
    cycle

    for subscribed users.


    ## Async Download Workflow


    Exporting leads is asynchronous:


    1. **Search** — `GET /api/companies/` to preview results and get
    `totalCount`

    2. **Export** — `POST /api/download-csv/` to start generation (credits
    deducted immediately)

    3. **Poll** — `GET /api/download-status/{search_id}/` until `status =
    COMPLETED`

    4. **Download** — `GET /api/download-completed-csv/{search_id}/` to get a
    signed URL


    ## API Keys (recommended for integrations)


    Generate a persistent API key from your dashboard under **API Keys**.


    Attach it to every request:

    ```
      Authorization: Token <your-api-key>
    ```


    Keys can be given an expiry date and revoked at any time.

    JWT Bearer tokens (`Authorization: Bearer <jwt>`) continue to work for
    browser sessions and Swagger UI testing.


    ## Rate Limiting


    API requests are rate-limited. If you receive a `429` response, back off and
    retry.


    ## Versioning


    This is **v1** of the API. Breaking changes will be communicated in advance.
servers:
  - url: https://www.spherescout.io
security: []
tags:
  - name: Authentication
    description: Register, login, refresh tokens, and reset passwords.
  - name: Search
    description: Search and preview business leads by country, category, and location.
  - name: Download
    description: 'Export leads to CSV/Excel. Async workflow: initiate → poll → download.'
  - name: History
    description: View past searches and their download status.
  - name: Credits & Profile
    description: Check credit balance, subscription plan, and user profile.
  - name: Geography
    description: Countries, states/regions, counties, and cities for search filters.
  - name: API Keys
    description: Create, list, and revoke persistent API keys for integrations.
paths:
  /api/locations/level2/:
    get:
      tags:
        - locations
      description: >-
        ViewSet for Level2 locations (counties/departments) with filtering
        support.


        Query parameters:

        - states: State IDs (repeated parameter format, e.g.,
        'states=46&states=44&states=51')

        - country: Country alpha2 code (e.g., 'AU', 'FR')


        Example: /api/locations/level2/?states=46&states=44&states=51&country=AU
      operationId: locations_level2_list
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Level2Location'
          description: ''
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: cURL
          source: |-
            curl -X GET 'https://www.spherescout.io/api/locations/level2/' \
              -H 'Authorization: Token YOUR_API_KEY' \
              -H 'User-Agent: SphereScout/1.0'
        - lang: Python
          source: |-
            import requests

            response = requests.get(
                "https://www.spherescout.io/api/locations/level2/",
                headers={
                    "Authorization": "Token YOUR_API_KEY",
                    "User-Agent": "SphereScout/1.0",
                },
            )
            print(response.json())
        - lang: JavaScript
          source: >-
            const response = await
            fetch("https://www.spherescout.io/api/locations/level2/", {
              headers: {
                "Authorization": "Token YOUR_API_KEY",
                "User-Agent": "SphereScout/1.0",
              },
            });

            const data = await response.json();
components:
  schemas:
    Level2Location:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        code:
          type: string
        level1_id:
          type: integer
        level1_name:
          type: string
      required:
        - code
        - id
        - name
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key. Format: Token <your-api-key>'

````