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

# Show an award

> Show a single awarded contract with transactions, sub-awards, related opportunities, program links, line items, places, classification codes, and contacts. The path parameter accepts either identifier shape: an all-digit value is treated as the Govly award database id; anything else is treated as the award uniqueKey (such as CONT_AWD_... or CONT_IDV_...).




## OpenAPI

````yaml /openapi/tools-v1.yaml get /api/tools/v1/awards/{id}
openapi: 3.1.0
info:
  title: Govly Tools API (Alpha)
  version: 1.0.0-alpha
  description: >
    ALPHA / UNSTABLE: This API is still in active development. Endpoint
    behavior, request fields, response fields, error codes, and operation names
    may change before the Tools API is declared stable.

    REST-callable tool surface for agent and automation workflows. Agents are
    the primary consumer, but integrations can be built on this API. Responses
    are JSON for typed clients; MCP tools may render action results into
    text-oriented formats separately.
servers:
  - url: https://app.govly.com
security:
  - bearerApiKey: []
  - headerApiKey: []
tags:
  - name: Opportunities
    description: Search, fetch, and inspect Govly opportunity records.
  - name: Awards
    description: Search and inspect awarded government contracts.
  - name: Workspaces
    description: Create, update, and inspect opportunity workspaces.
  - name: Workspace Members
    description: Add users and teams to workspaces.
  - name: Workspace Attachments
    description: List and upload workspace attachments.
  - name: Workspace Comments
    description: Post comments to workspaces.
  - name: Follows
    description: Follow opportunities and related workspace activity.
  - name: Saved Searches
    description: List saved opportunity searches and cached matches.
  - name: Documents
    description: >-
      Read document representations and request temporary original-file
      downloads.
  - name: Quote Submissions
    description: >-
      Inspect quote submission requirements, submit quotes, and poll submission
      status.
  - name: Inbox
    description: Read and triage the authenticated user's matched inbox items.
paths:
  /api/tools/v1/awards/{id}:
    get:
      tags:
        - Awards
      summary: Show an award
      description: >
        Show a single awarded contract with transactions, sub-awards, related
        opportunities, program links, line items, places, classification codes,
        and contacts. The path parameter accepts either identifier shape: an
        all-digit value is treated as the Govly award database id; anything else
        is treated as the award uniqueKey (such as CONT_AWD_... or
        CONT_IDV_...).
      operationId: show_award
      parameters:
        - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Award
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Award'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
components:
  parameters:
    id:
      name: id
      in: path
      required: true
      schema:
        type: string
  schemas:
    Award:
      type: object
      required:
        - id
      description: >
        Stable external award shape. Empty members are omitted rather than
        rendered blank, and money fields are JSON numbers. Detail responses
        (show_award) add bounded collections; search responses return the
        summary shape.
      properties:
        id:
          type: string
        uniqueKey:
          type: string
          description: Stable award business key, such as CONT_AWD_... or CONT_IDV_....
        displayName:
          type: string
        title:
          type: string
        identifier:
          type: string
        description:
          type: string
        aiSummary:
          type: string
        externalUrl:
          type: string
        awardUrl:
          type: string
        acquisitionType:
          type: string
        acquisitionCategory:
          type: string
        searchType:
          type: string
          enum:
            - fed
            - sled
            - international
        treasuryAccountIds:
          type: array
          items:
            type: string
        dates:
          type: object
          properties:
            awardedDate:
              type: string
            lastModifiedDate:
              type: string
            periodOfPerformanceStartDate:
              type: string
            periodOfPerformanceEndDate:
              type: string
            periodOfPerformancePotentialEndDate:
              type: string
        amounts:
          type: object
          properties:
            awardAmount:
              type: number
            obligatedAmount:
              type: number
            paidAmount:
              type: number
            ceilingAmount:
              type: number
        recipient:
          type: object
          properties:
            name:
              type: string
            uniqueKey:
              type: string
            uei:
              type: string
            cageCode:
              type: string
            parentUniqueKey:
              type: string
            parentName:
              type: string
        buyer:
          $ref: '#/components/schemas/AwardGovernmentEntity'
        buyingOffice:
          $ref: '#/components/schemas/AwardGovernmentEntity'
        funder:
          $ref: '#/components/schemas/AwardGovernmentEntity'
        fundingOffice:
          $ref: '#/components/schemas/AwardGovernmentEntity'
        classification:
          type: object
          properties:
            psc:
              type: string
            naics:
              type: string
            setAside:
              type: object
              properties:
                id:
                  type: string
                name:
                  type: string
                code:
                  type: string
        contractVehicle:
          type: object
          properties:
            id:
              type: string
            slug:
              type: string
            name:
              type: string
        parentAward:
          type: object
          properties:
            uniqueKey:
              type: string
            identifier:
              type: string
        jurisdiction:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            isoCode:
              type: string
        transactions:
          type: array
          description: Detail only. Up to 100, newest action first.
          items:
            type: object
        subAwards:
          type: array
          description: Detail only. Up to 100 award summaries.
          items:
            type: object
        subAwardsCount:
          type: integer
          description: Detail only.
        relatedOpportunities:
          type: array
          description: Detail only. Up to 25, newest posting first.
          items:
            type: object
        programLinks:
          type: array
          description: Detail only. Up to 100.
          items:
            type: object
        awardLineItems:
          type: array
          description: Detail only. Up to 100.
          items:
            type: object
        places:
          type: array
          description: Detail only. AI-extracted places, most specific category first.
          items:
            type: object
        classificationCodes:
          type: array
          description: Detail only. Up to 100 resolved classification codes with codeset.
          items:
            type: object
        contacts:
          type: array
          description: Detail only. Up to 100 associated contacts (id, name, email).
          items:
            type: object
    AwardGovernmentEntity:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        code:
          type: string
    ErrorEnvelope:
      type: object
      required:
        - errors
      properties:
        errors:
          type: array
          items:
            type: object
            required:
              - status
              - code
              - title
              - detail
            properties:
              status:
                type: string
              code:
                type: string
              title:
                type: string
              detail:
                type: string
              source:
                type: object
                properties:
                  pointer:
                    type: string
  responses:
    Error:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      bearerFormat: API key
    headerApiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````