---
title: "Get Provider By Location"
method: GET
path: "/api/v1/providers/by-location/{location}"
tags: ["providers"]
---

# Get Provider By Location

`GET /api/v1/providers/by-location/{location}`

## Path parameters

- `location` string, required

## Response `200`

Successful Response

- AgentstackServerApiSchemaCommonEntityModelClassGetitemLocalsModelOutput3
  - `source` union, required
    - string
    - string, uri
  - `id` string, uuid, required
  - `auto_stop_timeout` string, duration
  - `origin` string, required
  - `version_info` VersionInfo
    - `docker` ResolvedDockerImageID
      - `registry` string, required
      - `repository` string, required
      - `tag` string, required
      - `digest` string, required
      - `image_id` string, required
    - `github` ResolvedGithubUrl
      - `host` string
      - `org` string, required
      - `repo` string, required
      - `version` string, required
      - `version_type` 'head' | 'tag', required
      - `commit_hash` string, required
      - `path` string, nullable
  - `registry` union
    - string
    - string, uri
    - string, uri
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string, uuid, required
  - `last_active_at` string, date-time
  - `agent_card` AgentCardOutput, required — The AgentCard is a self-describing manifest for an agent. It provides essential metadata including the agent's identity, capabilities, skills, supported communication methods, and security requirements.
    - `additionalInterfaces` AgentInterface[], nullable
      - `transport` string, required
      - `url` string, required
    - `capabilities` AgentCapabilities, required — Defines optional capabilities supported by an agent.
      - `extensions` AgentExtension[], nullable
        - `description` string, nullable
        - `params` object, nullable
        - `required` boolean, nullable
        - `uri` string, required
      - `pushNotifications` boolean, nullable
      - `stateTransitionHistory` boolean, nullable
      - `streaming` boolean, nullable
    - `defaultInputModes` string[], required
    - `defaultOutputModes` string[], required
    - `description` string, required
    - `documentationUrl` string, nullable
    - `iconUrl` string, nullable
    - `name` string, required
    - `preferredTransport` string, nullable
    - `protocolVersion` string, nullable
    - `provider` AgentProvider — Represents the service provider of an agent.
      - `organization` string, required
      - `url` string, required
    - `security` object[], nullable
    - `securitySchemes` object, nullable
    - `signatures` AgentCardSignature[], nullable
      - `header` object, nullable
      - `protected` string, required
      - `signature` string, required
    - `skills` AgentSkill[], required
      - `description` string, required
      - `examples` string[], nullable
      - `id` string, required
      - `inputModes` string[], nullable
      - `name` string, required
      - `outputModes` string[], nullable
      - `security` object[], nullable
      - `tags` string[], required
    - `supportsAuthenticatedExtendedCard` boolean, nullable
    - `url` string, required
    - `version` string, required
  - `state` union, required
    - 'missing' | 'starting' | 'ready' | 'running' | 'error'
    - 'online' | 'offline'
  - `last_error` ProviderErrorMessage
    - `message` string, required
  - `missing_configuration` EnvVar[]
    - `name` string, required
    - `description` string, nullable
    - `required` boolean
  - `type` 'managed' | 'unmanaged', required
  - `managed` boolean, required
  - `env` EnvVar[], required
    - `name` string, required
    - `description` string, nullable
    - `required` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/i-am-bee/apis/agentstack-server.md) · [All operations](https://skmtc.net/i-am-bee/apis/agentstack-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/i-am-bee/agentstack-server/revisions/7d68b3f8bf7f/schema)