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

# Get an agency

<Note>
  **The Hive Inspect API is a work in progress.** It is available to a small group of accounts today, and the release for everyone is coming very soon.
</Note>


## OpenAPI

````yaml /api/openapi.json get /v1/agencies/{agencyId}
openapi: 3.1.0
info:
  title: Hive Inspect API
  version: 1.0.0
  description: Connect other tools to your Hive Inspect contacts, inspections and events.
servers:
  - url: https://api.hiveinspect.com
security:
  - bearerAuth: []
tags:
  - name: Contacts
    description: Agents, clients and every other contact in your organization.
  - name: Agencies
    description: The brokerages your agents belong to. Read-only.
  - name: Inspections
    description: Read-only access to your inspections.
  - name: Attachments
    description: Additional reports and additional documents on an inspection.
  - name: Events
    description: Extra appointments on an inspection, such as a radon drop-off or pick-up.
paths:
  /v1/agencies/{agencyId}:
    get:
      tags:
        - Agencies
      summary: Get an agency
      operationId: getAgency
      parameters:
        - name: agencyId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agency'
        '400':
          description: Invalid parameter
        '401':
          description: Missing, invalid or inactive API key
        '404':
          description: Not found
        '429':
          description: Rate limit exceeded (120 requests/minute per key owner)
components:
  schemas:
    Agency:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        address:
          type:
            - string
            - 'null'
        address_line2:
          type:
            - string
            - 'null'
        city:
          type:
            - string
            - 'null'
        state:
          type:
            - string
            - 'null'
        zip:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
        phone:
          type:
            - string
            - 'null'
        website:
          type:
            - string
            - 'null'
        notes:
          type:
            - string
            - 'null'
        contact_count:
          type: integer
          description: Contacts linked to this agency
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      example:
        id: 6c5b4a39-2817-4f6e-9d0c-8b7a6f5e4d3c
        name: Lone Star Realty
        address: 410 Oak St
        address_line2: Suite 200
        city: Austin
        state: TX
        zip: '78701'
        country: US
        phone: (512) 555-0100
        website: https://lonestarrealty.example.com
        notes: null
        contact_count: 12
        created_at: '2026-02-11T17:30:00Z'
        updated_at: '2026-08-05T14:12:44Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key from Business Tools → API Access.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.