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

# Get a detection's resolved connections

> The agent-ready payload for a prior /detect: one connection per detected provider with its resolved `actionUrl` (the exact transaction surface: booking page, ordering page). Readable only by the creating key. Raw provider params are never returned.



## OpenAPI

````yaml openapi.json GET /api/v1/detections/{id}
openapi: 3.1.0
info:
  title: Vine API
  version: extraction.v1
  description: >-
    Beta. Live provider detection: a business URL in → the customer-facing
    software it transacts through, with a resolved action URL per provider. A
    live detect typically takes 1–2 minutes; a deadline hit returns
    `detection_incomplete` (retryable), never a hang.
servers:
  - url: https://vine.getcourtyard.ai
security:
  - bearerAuth: []
paths:
  /api/v1/detections/{id}:
    get:
      summary: Get a detection's resolved connections
      description: >-
        The agent-ready payload for a prior /detect: one connection per detected
        provider with its resolved `actionUrl` (the exact transaction surface:
        booking page, ordering page). Readable only by the creating key. Raw
        provider params are never returned.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: A `detectionId` from /detect (`det_…`).
      responses:
        '200':
          description: The detection with its resolved connections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DetectionDetail'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
components:
  schemas:
    DetectionDetail:
      type: object
      properties:
        schemaVersion:
          type: string
        detectionId:
          type: string
        url:
          type: string
        fetchedUrl:
          type: string
          nullable: true
        providers:
          type: array
          items:
            type: string
        discoveredProviders:
          type: array
          items:
            type: object
            properties:
              slug:
                type: string
              name:
                type: string
              evidenceUrl:
                type: string
        createdAt:
          type: string
          format: date-time
        paramsResolvedAt:
          type: string
          format: date-time
          nullable: true
          description: >-
            When provider params finished resolving. Null while the async
            param-rescue step is still pending; non-null once resolved.
        connections:
          type: array
          description: 'One per detected provider: the actionable artifact of a detect.'
          items:
            type: object
            properties:
              provider:
                type: string
              actionType:
                type: string
                nullable: true
                description: What a customer does there (e.g. book, order).
              actionUrl:
                type: string
                nullable: true
                description: 'The resolved transaction surface: the URL an agent acts on.'
              status:
                type: string
              userConfirmed:
                type: boolean
                nullable: true
              lastRefreshedAt:
                type: string
                format: date-time
                nullable: true
              hasParams:
                type: boolean
                description: >-
                  Whether resolved provider params exist server-side (never
                  exposed).
  responses:
    Error:
      description: Error envelope.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: vine_live_… API key

````