GUILD Public Opportunity Feed

A small backend-only API for approved media and channel partners. It returns up to five GUILD-curated public opportunities for the current week.

Endpoint GET /api/integrations/opportunity-feed

Auth Authorization: Bearer <token>

Base URL https://app.guildai.co

Overview

The feed is intentionally narrow. It is designed for publication surfaces, not for database access or internal GUILD workflows. Partners receive item names, descriptions, quantities, estimated manufacturing value, lead time, public sample images, required certifications, and a public engagement URL.

The current engagement URL is https://apply.guildai.co. Tokens are issued per approved backend integration and can be revoked independently.

Quickstart

Call the endpoint from your server. Do not call it from browser JavaScript or ship the token to a client application.

curl -sS "https://app.guildai.co/api/integrations/opportunity-feed" \
  -H "Authorization: Bearer <GUILD_OPPORTUNITY_FEED_TOKEN>" \
  -H "Accept: application/json"

Authentication

GUILD issues an opaque Bearer token for each approved integration. Store the token in backend secret storage. Rotate it when staff, vendors, or hosting environments change.

Do not send tokens by email, chat, screenshots, support tickets, or frontend telemetry.

Response

A successful request returns ok: true, integration client metadata, and an opportunities array with at most five records.

Fields

Field	Description
`rank`	Display order, starting at 1.
`weekStart`	Week represented by the curated pick.
`solicitationNumber`	Public solicitation identifier.
`nsn`	National Stock Number when available.
`itemName`	Human-readable item name.
`description`	Public display description.
`quantity`	Requested quantity.
`estimatedSupplierManufacturingValue`	Estimated supplier or manufacturing value in USD.
`leadTime`	Expected production or delivery lead time.
`sampleImageUrl`	Public GUILD-controlled product image URL.
`requiredCertifications`	Required or expected certification labels.
`engagementUrl`	Public intake URL for manufacturers.

Example

{
  "ok": true,
  "client": {
    "id": "11111111-1111-4111-8111-111111111111",
    "slug": "partner-news-client"
  },
  "opportunities": [
    {
      "rank": 1,
      "weekStart": "2026-06-22",
      "solicitationNumber": "SPE4A6-26-T-0000",
      "nsn": "5310-00-000-0000",
      "itemName": "Precision fastener assembly",
      "description": "Curated public manufacturing opportunity with defense supply relevance.",
      "quantity": 1250,
      "estimatedSupplierManufacturingValue": 87500,
      "leadTime": "90 days",
      "sampleImageUrl": "https://app.guildai.co/public/opportunity-images/sample-fastener.jpg",
      "sampleImageAlt": "Precision fastener assembly",
      "requiredCertifications": ["ISO 9001", "ITAR readiness"],
      "engagementUrl": "https://apply.guildai.co"
    }
  ]
}

Operational Notes

Poll no more than once every 15 minutes unless GUILD confirms otherwise.
Respect the returned Cache-Control header. The current endpoint returns no-store.
Use one token per approved partner integration.
Request revocation immediately if a token is exposed.

Errors

Status	Meaning
`401`	Missing, malformed, expired, disabled, or invalid token.
`405`	Method other than `GET`.
`429`	Request volume exceeds the agreed integration pattern.
`500`	Feed unavailable or a required curated field failed validation.

Error responses are intentionally terse and use a redacted error string.