{ "openapi": "3.1.0", "info": { "title": "Ausschreibungsagenten Public API", "version": "0.1.0", "description": "Typed API for public tender search, source freshness, country coverage, company profiles, A2A and MCP.", "license": { "name": "Proprietary", "url": "https://www.ausschreibungsagenten.de/agb" }, "x-deprecation-policy": "Incompatible removals are announced at least 12 months ahead with Deprecation and Sunset headers." }, "paths": { "/api/v1/health": { "get": { "tags": [ "tenders" ], "summary": "Health", "operationId": "health_api_v1_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthOut" } } } } }, "description": "Health" } }, "/api/v1/source-status": { "get": { "tags": [ "tenders" ], "summary": "Source Status", "operationId": "source_status_api_v1_source_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/SourceStatusOut" }, "type": "array", "title": "Response Source Status Api V1 Source Status Get" } } } } }, "description": "Source Status" } }, "/api/v1/cpv": { "get": { "tags": [ "tenders" ], "summary": "Cpv List", "operationId": "cpv_list_api_v1_cpv_get", "parameters": [ { "name": "vertical", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vertical" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CPVEntry" }, "title": "Response Cpv List Api V1 Cpv Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Cpv List" } }, "/api/v1/public/countries": { "get": { "tags": [ "tenders" ], "summary": "Public Countries", "description": "Öffentliche Länderliste des Index mit Tender-Zahl (für Statusseiten/Facetten).", "operationId": "public_countries_api_v1_public_countries_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "additionalProperties": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "type": "object" }, "type": "array", "title": "Response Public Countries Api V1 Public Countries Get" } } } } } } }, "/api/v1/public/tenders": { "get": { "tags": [ "tenders" ], "summary": "Public Tenders", "description": "Small public search surface for landing pages and SEO previews.\n\nThe authenticated API remains the paid product surface for broad exports,\nfull text search, higher limits, document analysis, and agent workflows.", "operationId": "public_tenders_api_v1_public_tenders_get", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "DEU", "title": "Country" } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Search" } }, { "name": "cpv", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "comma-separated CPV codes", "title": "Cpv" }, "description": "comma-separated CPV codes" }, { "name": "vertical", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vertical" } }, { "name": "performance_region", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Performance Region" } }, { "name": "minimum_value_eur", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Minimum Value Eur" } }, { "name": "maximum_value_eur", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Maximum Value Eur" } }, { "name": "deadline_within_days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "maximum": 365, "minimum": 1 }, { "type": "null" } ], "title": "Deadline Within Days" } }, { "name": "only_active", "in": "query", "required": false, "schema": { "type": "boolean", "description": "deadline in future or unknown", "default": true, "title": "Only Active" }, "description": "deadline in future or unknown" }, { "name": "min_score", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 60, "title": "Min Score" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 25, "minimum": 1, "default": 10, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "summary_lang", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 2, "maxLength": 2 }, { "type": "null" } ], "description": "ISO 639-1 code for cached AI summaries (e.g. 'en'); silently ignored if the feature or language is unavailable", "title": "Summary Lang" }, "description": "ISO 639-1 code for cached AI summaries (e.g. 'en'); silently ignored if the feature or language is unavailable" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PublicTenderOut" }, "title": "Response Public Tenders Api V1 Public Tenders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tenders": { "get": { "tags": [ "tenders" ], "summary": "List Tenders", "operationId": "list_tenders_api_v1_tenders_get", "parameters": [ { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "country", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country" } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Search" } }, { "name": "cpv", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "comma-separated CPV codes", "title": "Cpv" }, "description": "comma-separated CPV codes" }, { "name": "vertical", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vertical" } }, { "name": "performance_region", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Performance Region" } }, { "name": "minimum_value_eur", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Minimum Value Eur" } }, { "name": "maximum_value_eur", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Maximum Value Eur" } }, { "name": "deadline_within_days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "maximum": 365, "minimum": 1 }, { "type": "null" } ], "title": "Deadline Within Days" } }, { "name": "only_active", "in": "query", "required": false, "schema": { "type": "boolean", "description": "deadline in future or unknown", "default": true, "title": "Only Active" }, "description": "deadline in future or unknown" }, { "name": "min_score", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 0, "title": "Min Score" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TenderOut" }, "title": "Response List Tenders Api V1 Tenders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "tenders:read" ] } ], "description": "List Tenders" } }, "/api/v1/tenders/search": { "get": { "tags": [ "tenders" ], "summary": "Fts Search", "operationId": "fts_search_api_v1_tenders_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "title": "Q" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 25, "title": "Limit" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TenderOut" }, "title": "Response Fts Search Api V1 Tenders Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "tenders:read" ] } ], "description": "Fts Search" } }, "/api/v1/tenders/{tender_id}": { "get": { "tags": [ "tenders" ], "summary": "Get Tender By Id", "operationId": "get_tender_by_id_api_v1_tenders__tender_id__get", "parameters": [ { "name": "tender_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tender Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenderOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "tenders:read" ] } ], "description": "Get Tender By Id" } }, "/api/v1/stats": { "get": { "tags": [ "tenders" ], "summary": "Stats", "operationId": "stats_api_v1_stats_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatsOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "tenders:read" ] } ], "description": "Stats" } }, "/api/v1/public/company-profiles": { "post": { "tags": [ "profiles" ], "summary": "Create Public Company Profile", "operationId": "create_public_company_profile_api_v1_public_company_profiles_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyProfileIn" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyProfileCreatedOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Create Public Company Profile" } }, "/api/v1/company-profiles/{profile_id}": { "get": { "tags": [ "profiles" ], "summary": "Get Company Profile", "operationId": "get_company_profile_api_v1_company_profiles__profile_id__get", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyProfileOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "profiles:read" ] } ], "description": "Get Company Profile" } }, "/api/v1/public/company-profiles/{profile_id}/export": { "get": { "tags": [ "profiles" ], "summary": "Export Public Company Profile", "operationId": "export_public_company_profile_api_v1_public_company_profiles__profile_id__export_get", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "email", "in": "query", "required": true, "schema": { "type": "string", "title": "Email" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyProfileOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Export Public Company Profile" } }, "/api/v1/public/company-profiles/{profile_id}": { "delete": { "tags": [ "profiles" ], "summary": "Delete Public Company Profile", "operationId": "delete_public_company_profile_api_v1_public_company_profiles__profile_id__delete", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileDeleteIn" } } } }, "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Delete Public Company Profile" } }, "/api/v1/public/company-profiles/{profile_id}/matches": { "get": { "tags": [ "profiles" ], "summary": "Public Company Profile Matches", "description": "Compatibility endpoint for the Vercel lead flow.\n\nIt exposes tender matches only, never profile PII. The protected pilot surface\nbelow is used for notes, status changes and exports.", "operationId": "public_company_profile_matches_api_v1_public_company_profiles__profile_id__matches_get", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "only_active", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Only Active" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 25, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CompanyTenderMatchOut" }, "title": "Response Public Company Profile Matches Api V1 Public Company Profiles Profile Id Matches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/pilot/{profile_id}/{access_token}/matches": { "get": { "tags": [ "profiles" ], "summary": "Protected Pilot Matches", "operationId": "protected_pilot_matches_api_v1_pilot__profile_id___access_token__matches_get", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "minimum_score", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 35, "title": "Minimum Score" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 250, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CompanyTenderMatchOut" }, "title": "Response Protected Pilot Matches Api V1 Pilot Profile Id Access Token Matches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Protected Pilot Matches" } }, "/api/v1/pilot/{profile_id}/{access_token}/tenders/{tender_id}": { "put": { "tags": [ "profiles" ], "summary": "Update Pilot Tender State", "operationId": "update_pilot_tender_state_api_v1_pilot__profile_id___access_token__tenders__tender_id__put", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "tender_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tender Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PilotTenderStateIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyTenderMatchOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Update Pilot Tender State" } }, "/api/v1/pilot/{profile_id}/{access_token}/digest": { "post": { "tags": [ "profiles" ], "summary": "Run Pilot Digest", "description": "Generate a test preview or explicitly trigger a configured real digest.", "operationId": "run_pilot_digest_api_v1_pilot__profile_id___access_token__digest_post", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "test_mode", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Test Mode" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DigestRunOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/pilot/{profile_id}/{access_token}/gaeb/analyze": { "post": { "tags": [ "gaeb" ], "summary": "Analyze Gaeb Upload", "operationId": "analyze_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_analyze_post", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Search" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_analyze_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_analyze_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GaebAnalysisOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Analyze Gaeb Upload" } }, "/api/v1/pilot/{profile_id}/{access_token}/gaeb/export": { "post": { "tags": [ "gaeb" ], "summary": "Export Gaeb Upload", "operationId": "export_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_export_post", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "format", "in": "query", "required": false, "schema": { "enum": [ "csv", "xlsx" ], "type": "string", "default": "csv", "title": "Format" } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Search" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_export_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_export_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Export Gaeb Upload" } }, "/api/v1/pilot/{profile_id}/{access_token}/tenders/{tender_id}/export": { "get": { "tags": [ "erp-export" ], "summary": "Export Tender", "operationId": "export_tender_api_v1_pilot__profile_id___access_token__tenders__tender_id__export_get", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "tender_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tender Id" } }, { "name": "format", "in": "query", "required": false, "schema": { "enum": [ "json", "csv", "xlsx" ], "type": "string", "default": "json", "title": "Format" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Export Tender" } }, "/api/v1/pilot/{profile_id}/{access_token}/tenders/{tender_id}/erp-webhook": { "post": { "tags": [ "erp-export" ], "summary": "Deliver Tender To Erp Webhook", "operationId": "deliver_tender_to_erp_webhook_api_v1_pilot__profile_id___access_token__tenders__tender_id__erp_webhook_post", "parameters": [ { "name": "profile_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Profile Id" } }, { "name": "access_token", "in": "path", "required": true, "schema": { "type": "string", "title": "Access Token" } }, { "name": "tender_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tender Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ERPWebhookResultOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Deliver Tender To Erp Webhook" } }, "/api/v1/me/keys": { "get": { "tags": [ "keys" ], "summary": "List Api Keys", "operationId": "list_api_keys_api_v1_me_keys_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ApiKeyOut" }, "title": "Response List Api Keys Api V1 Me Keys Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [] } ], "description": "List Api Keys" }, "post": { "tags": [ "keys" ], "summary": "Create Api Key", "operationId": "create_api_key_api_v1_me_keys_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiKeyCreateIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiKeyCreateOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [] } ], "description": "Create Api Key" } }, "/api/v1/me/keys/{key_id}": { "delete": { "tags": [ "keys" ], "summary": "Revoke Api Key", "operationId": "revoke_api_key_api_v1_me_keys__key_id__delete", "parameters": [ { "name": "key_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Key Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [] } ], "description": "Revoke Api Key" } }, "/api/v1/me/webhooks": { "get": { "tags": [ "webhooks" ], "summary": "List Webhooks", "operationId": "list_webhooks_api_v1_me_webhooks_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookOut" }, "title": "Response List Webhooks Api V1 Me Webhooks Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "webhooks:write" ] } ], "description": "List Webhooks" }, "post": { "tags": [ "webhooks" ], "summary": "Create Webhook", "operationId": "create_webhook_api_v1_me_webhooks_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "webhooks:write" ] } ], "description": "Create Webhook" } }, "/api/v1/me/webhooks/{webhook_id}": { "delete": { "tags": [ "webhooks" ], "summary": "Delete Webhook", "operationId": "delete_webhook_api_v1_me_webhooks__webhook_id__delete", "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Webhook Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "webhooks:write" ] } ], "description": "Delete Webhook" } }, "/api/v1/signup": { "post": { "tags": [ "signup" ], "summary": "Signup", "operationId": "signup_api_v1_signup_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignupIn" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignupOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Signup" } }, "/api/standard": { "get": { "tags": [ "agent-discovery" ], "summary": "Agent Standard", "operationId": "agent_standard_api_standard_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Agent Standard Api Standard Get" } } } } }, "description": "Agent Standard" } }, "/.well-known/glama.json": { "get": { "tags": [ "agent-discovery" ], "summary": "Glama Connector Claim", "operationId": "glama_connector_claim__well_known_glama_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Glama Connector Claim Well Known Glama Json Get" } } } } }, "description": "Glama Connector Claim" } }, "/.well-known/agent-card.json": { "get": { "tags": [ "agent-discovery" ], "summary": "Agent Card", "operationId": "agent_card__well_known_agent_card_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Agent Card Well Known Agent Card Json Get" } } } } }, "description": "Agent Card" } }, "/llms.txt": { "get": { "tags": [ "agent-discovery" ], "summary": "Llms Txt", "operationId": "llms_txt_llms_txt_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "description": "Llms Txt" } }, "/server.json": { "get": { "tags": [ "agent-discovery" ], "summary": "Mcp Server Json", "operationId": "mcp_server_json_server_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mcp Server Json Server Json Get" } } } } }, "description": "Mcp Server Json" } }, "/api/a2a": { "post": { "tags": [ "agent-discovery" ], "summary": "A2A Jsonrpc", "operationId": "a2a_jsonrpc_api_a2a_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response A2A Jsonrpc Api A2A Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "A2A Jsonrpc" } }, "/.well-known/mcp/server-card.json": { "get": { "tags": [ "agent-discovery" ], "summary": "Mcp Server Card", "description": "Die Server Card aus derselben Quelle wie die Werkzeugliste.\n\nVorher war sie eine handgepflegte Datei auf der Website - und lief\nauseinander: sie nannte zwei statt sechs Werkzeuge, andere Namen als der\nServer wirklich fuehrt (`search_tenders` statt `agentleads.search_tenders`)\nund `openWorldHint: true`, wo der Server `false` sagt. Wer eine Karte und\nden Server nebeneinander liest - ein Verzeichnis, ein Review - sieht dann\nzwei verschiedene Dinge.", "operationId": "mcp_server_card__well_known_mcp_server_card_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mcp Server Card Well Known Mcp Server Card Json Get" } } } } } } }, "/mcp": { "post": { "tags": [ "mcp" ], "summary": "Mcp Endpoint", "operationId": "mcp_endpoint_mcp_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Mcp Endpoint Mcp Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "apiKeyBearer": [] }, { "oauth2ClientCredentials": [ "tenders:read", "fulltext:read" ] }, {} ], "description": "Mcp Endpoint" } }, "/oauth/token": { "post": { "tags": [ "oauth" ], "summary": "Issue an access token", "operationId": "token_oauth_token_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_token_oauth_token_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Issue an access token" } }, "/.well-known/oauth-authorization-server": { "get": { "tags": [ "oauth" ], "summary": "Authorization server metadata", "operationId": "authorization_server_metadata__well_known_oauth_authorization_server_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Authorization Server Metadata Well Known Oauth Authorization Server Get" } } } } }, "description": "Authorization server metadata" } }, "/.well-known/oauth-protected-resource": { "get": { "tags": [ "oauth" ], "summary": "Protected resource metadata", "operationId": "protected_resource_metadata__well_known_oauth_protected_resource_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Protected Resource Metadata Well Known Oauth Protected Resource Get" } } } } }, "description": "Protected resource metadata" } } }, "components": { "schemas": { "ApiKeyCreateIn": { "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" } }, "type": "object", "title": "ApiKeyCreateIn" }, "ApiKeyCreateOut": { "properties": { "id": { "type": "string", "title": "Id" }, "key_prefix": { "type": "string", "title": "Key Prefix" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "last_used_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Used At" }, "revoked_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Revoked At" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "api_key": { "type": "string", "title": "Api Key" } }, "type": "object", "required": [ "id", "key_prefix", "created_at", "api_key" ], "title": "ApiKeyCreateOut" }, "ApiKeyOut": { "properties": { "id": { "type": "string", "title": "Id" }, "key_prefix": { "type": "string", "title": "Key Prefix" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "last_used_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Used At" }, "revoked_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Revoked At" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "key_prefix", "created_at" ], "title": "ApiKeyOut" }, "Body_analyze_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_analyze_post": { "properties": { "file": { "type": "string", "contentMediaType": "application/octet-stream", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_analyze_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_analyze_post" }, "Body_export_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_export_post": { "properties": { "file": { "type": "string", "contentMediaType": "application/octet-stream", "title": "File" } }, "type": "object", "required": [ "file" ], "title": "Body_export_gaeb_upload_api_v1_pilot__profile_id___access_token__gaeb_export_post" }, "Body_token_oauth_token_post": { "properties": { "grant_type": { "type": "string", "title": "Grant Type", "default": "" }, "scope": { "type": "string", "title": "Scope", "default": "" }, "client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Id" }, "client_secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Secret" } }, "type": "object", "title": "Body_token_oauth_token_post" }, "CPVEntry": { "properties": { "code": { "type": "string", "title": "Code" }, "label": { "type": "string", "title": "Label" }, "vertical": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vertical" } }, "type": "object", "required": [ "code", "label" ], "title": "CPVEntry" }, "CompanyProfileCreatedOut": { "properties": { "id": { "type": "string", "title": "Id" }, "email": { "type": "string", "title": "Email" }, "company": { "type": "string", "title": "Company" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "services": { "type": "string", "title": "Services" }, "budget": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Budget" }, "frequency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Frequency" }, "selected_verticals": { "items": { "type": "string" }, "type": "array", "title": "Selected Verticals" }, "included_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Included Cpv Codes" }, "excluded_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Excluded Cpv Codes" }, "positive_keywords": { "items": { "type": "string" }, "type": "array", "title": "Positive Keywords" }, "negative_keywords": { "items": { "type": "string" }, "type": "array", "title": "Negative Keywords" }, "capabilities": { "items": { "type": "string" }, "type": "array", "title": "Capabilities" }, "reference_projects": { "items": { "type": "string" }, "type": "array", "title": "Reference Projects" }, "used_portals": { "items": { "type": "string" }, "type": "array", "title": "Used Portals" }, "current_search_terms": { "items": { "type": "string" }, "type": "array", "title": "Current Search Terms" }, "existing_alerts": { "items": { "type": "string" }, "type": "array", "title": "Existing Alerts" }, "go_no_go_rules": { "items": { "type": "string" }, "type": "array", "title": "Go No Go Rules" }, "preferred_buyer_clusters": { "items": { "type": "string" }, "type": "array", "title": "Preferred Buyer Clusters" }, "early_signal_keywords": { "items": { "type": "string" }, "type": "array", "title": "Early Signal Keywords" }, "pilot_user_emails": { "items": { "type": "string" }, "type": "array", "title": "Pilot User Emails" }, "prequalification_number": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prequalification Number" }, "prequalification_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prequalification Status" }, "target_countries": { "items": { "type": "string" }, "type": "array", "title": "Target Countries" }, "target_regions": { "items": { "type": "string" }, "type": "array", "title": "Target Regions" }, "target_nuts_codes": { "items": { "type": "string" }, "type": "array", "title": "Target Nuts Codes" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code" }, "radius_km": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Radius Km" }, "location_mode": { "type": "string", "title": "Location Mode", "default": "priority" }, "minimum_contract_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Minimum Contract Value Eur" }, "maximum_contract_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Maximum Contract Value Eur" }, "preferred_notification_frequency": { "type": "string", "title": "Preferred Notification Frequency" }, "only_active": { "type": "boolean", "title": "Only Active" }, "minimum_days_until_deadline": { "type": "integer", "title": "Minimum Days Until Deadline" }, "notifications_enabled": { "type": "boolean", "title": "Notifications Enabled" }, "source": { "type": "string", "title": "Source" }, "status": { "type": "string", "title": "Status" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "access_token": { "type": "string", "title": "Access Token" }, "pilot_url": { "type": "string", "title": "Pilot Url" } }, "type": "object", "required": [ "id", "email", "company", "services", "preferred_notification_frequency", "only_active", "minimum_days_until_deadline", "notifications_enabled", "source", "status", "created_at", "access_token", "pilot_url" ], "title": "CompanyProfileCreatedOut" }, "CompanyProfileIn": { "properties": { "email": { "type": "string", "format": "email", "title": "Email" }, "company": { "type": "string", "title": "Company" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "services": { "type": "string", "title": "Services" }, "budget": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Budget" }, "frequency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Frequency" }, "selected_verticals": { "items": { "type": "string" }, "type": "array", "title": "Selected Verticals" }, "included_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Included Cpv Codes" }, "excluded_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Excluded Cpv Codes" }, "positive_keywords": { "items": { "type": "string" }, "type": "array", "title": "Positive Keywords" }, "negative_keywords": { "items": { "type": "string" }, "type": "array", "title": "Negative Keywords" }, "capabilities": { "items": { "type": "string" }, "type": "array", "title": "Capabilities" }, "reference_projects": { "items": { "type": "string" }, "type": "array", "title": "Reference Projects" }, "used_portals": { "items": { "type": "string" }, "type": "array", "title": "Used Portals" }, "current_search_terms": { "items": { "type": "string" }, "type": "array", "title": "Current Search Terms" }, "existing_alerts": { "items": { "type": "string" }, "type": "array", "title": "Existing Alerts" }, "go_no_go_rules": { "items": { "type": "string" }, "type": "array", "title": "Go No Go Rules" }, "preferred_buyer_clusters": { "items": { "type": "string" }, "type": "array", "title": "Preferred Buyer Clusters" }, "early_signal_keywords": { "items": { "type": "string" }, "type": "array", "title": "Early Signal Keywords" }, "pilot_user_emails": { "items": { "type": "string", "format": "email" }, "type": "array", "title": "Pilot User Emails" }, "prequalification_number": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "title": "Prequalification Number" }, "prequalification_status": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "title": "Prequalification Status" }, "target_countries": { "items": { "type": "string" }, "type": "array", "title": "Target Countries" }, "target_regions": { "items": { "type": "string" }, "type": "array", "title": "Target Regions" }, "target_nuts_codes": { "items": { "type": "string" }, "type": "array", "title": "Target Nuts Codes" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code" }, "radius_km": { "anyOf": [ { "type": "integer", "maximum": 2000, "minimum": 0 }, { "type": "null" } ], "title": "Radius Km" }, "location_mode": { "type": "string", "enum": [ "nationwide", "priority", "strict" ], "title": "Location Mode", "default": "priority" }, "minimum_contract_value_eur": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Minimum Contract Value Eur" }, "maximum_contract_value_eur": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Maximum Contract Value Eur" }, "preferred_notification_frequency": { "type": "string", "enum": [ "off", "daily", "weekly" ], "title": "Preferred Notification Frequency", "default": "weekly" }, "only_active": { "type": "boolean", "title": "Only Active", "default": true }, "minimum_days_until_deadline": { "type": "integer", "maximum": 365, "minimum": 0, "title": "Minimum Days Until Deadline", "default": 0 }, "source": { "type": "string", "title": "Source", "default": "website" } }, "type": "object", "required": [ "email", "company", "services" ], "title": "CompanyProfileIn" }, "CompanyProfileOut": { "properties": { "id": { "type": "string", "title": "Id" }, "email": { "type": "string", "title": "Email" }, "company": { "type": "string", "title": "Company" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "services": { "type": "string", "title": "Services" }, "budget": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Budget" }, "frequency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Frequency" }, "selected_verticals": { "items": { "type": "string" }, "type": "array", "title": "Selected Verticals" }, "included_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Included Cpv Codes" }, "excluded_cpv_codes": { "items": { "type": "string" }, "type": "array", "title": "Excluded Cpv Codes" }, "positive_keywords": { "items": { "type": "string" }, "type": "array", "title": "Positive Keywords" }, "negative_keywords": { "items": { "type": "string" }, "type": "array", "title": "Negative Keywords" }, "capabilities": { "items": { "type": "string" }, "type": "array", "title": "Capabilities" }, "reference_projects": { "items": { "type": "string" }, "type": "array", "title": "Reference Projects" }, "used_portals": { "items": { "type": "string" }, "type": "array", "title": "Used Portals" }, "current_search_terms": { "items": { "type": "string" }, "type": "array", "title": "Current Search Terms" }, "existing_alerts": { "items": { "type": "string" }, "type": "array", "title": "Existing Alerts" }, "go_no_go_rules": { "items": { "type": "string" }, "type": "array", "title": "Go No Go Rules" }, "preferred_buyer_clusters": { "items": { "type": "string" }, "type": "array", "title": "Preferred Buyer Clusters" }, "early_signal_keywords": { "items": { "type": "string" }, "type": "array", "title": "Early Signal Keywords" }, "pilot_user_emails": { "items": { "type": "string" }, "type": "array", "title": "Pilot User Emails" }, "prequalification_number": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prequalification Number" }, "prequalification_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prequalification Status" }, "target_countries": { "items": { "type": "string" }, "type": "array", "title": "Target Countries" }, "target_regions": { "items": { "type": "string" }, "type": "array", "title": "Target Regions" }, "target_nuts_codes": { "items": { "type": "string" }, "type": "array", "title": "Target Nuts Codes" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code" }, "radius_km": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Radius Km" }, "location_mode": { "type": "string", "title": "Location Mode", "default": "priority" }, "minimum_contract_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Minimum Contract Value Eur" }, "maximum_contract_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Maximum Contract Value Eur" }, "preferred_notification_frequency": { "type": "string", "title": "Preferred Notification Frequency" }, "only_active": { "type": "boolean", "title": "Only Active" }, "minimum_days_until_deadline": { "type": "integer", "title": "Minimum Days Until Deadline" }, "notifications_enabled": { "type": "boolean", "title": "Notifications Enabled" }, "source": { "type": "string", "title": "Source" }, "status": { "type": "string", "title": "Status" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "email", "company", "services", "preferred_notification_frequency", "only_active", "minimum_days_until_deadline", "notifications_enabled", "source", "status", "created_at" ], "title": "CompanyProfileOut" }, "CompanyTenderMatchOut": { "properties": { "tender": { "$ref": "#/components/schemas/PublicTenderOut" }, "match_score": { "type": "integer", "title": "Match Score" }, "technical_score": { "type": "integer", "title": "Technical Score", "default": 0 }, "geography_tier": { "type": "string", "title": "Geography Tier", "default": "review" }, "geography_label": { "type": "string", "title": "Geography Label", "default": "Prüfen · Leistungsort fehlt" }, "distance_km": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Distance Km" }, "reasons": { "items": { "type": "string" }, "type": "array", "title": "Reasons" }, "score_components": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Score Components" }, "status": { "type": "string", "title": "Status", "default": "new" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "reference_project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reference Project" }, "next_action": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Action" }, "go_no_go": { "anyOf": [ { "$ref": "#/components/schemas/GoNoGoCardOut" }, { "type": "null" } ] } }, "type": "object", "required": [ "tender", "match_score" ], "title": "CompanyTenderMatchOut" }, "DigestRunOut": { "properties": { "profile_id": { "type": "string", "title": "Profile Id" }, "dry_run": { "type": "boolean", "title": "Dry Run" }, "candidates": { "type": "integer", "title": "Candidates" }, "delivered": { "type": "integer", "title": "Delivered" }, "skipped_duplicate": { "type": "integer", "title": "Skipped Duplicate" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject" }, "preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preview" } }, "type": "object", "required": [ "profile_id", "dry_run", "candidates", "delivered", "skipped_duplicate" ], "title": "DigestRunOut" }, "ERPWebhookResultOut": { "properties": { "adapter": { "type": "string", "title": "Adapter" }, "delivered": { "type": "boolean", "title": "Delivered" }, "status_code": { "type": "integer", "title": "Status Code" } }, "type": "object", "required": [ "adapter", "delivered", "status_code" ], "title": "ERPWebhookResultOut" }, "GaebAnalysisOut": { "properties": { "exchange_phase": { "type": "string", "enum": [ "X83", "X84" ], "title": "Exchange Phase" }, "gaeb_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Gaeb Version" }, "project_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Name" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" }, "boq_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Boq Name" }, "position_count": { "type": "integer", "title": "Position Count" }, "sections": { "items": { "$ref": "#/components/schemas/GaebSectionSummaryOut" }, "type": "array", "title": "Sections" }, "positions": { "items": { "$ref": "#/components/schemas/GaebPositionOut" }, "type": "array", "title": "Positions" } }, "type": "object", "required": [ "exchange_phase", "position_count" ], "title": "GaebAnalysisOut" }, "GaebPositionOut": { "properties": { "section": { "type": "string", "title": "Section" }, "ordinal": { "type": "string", "title": "Ordinal" }, "short_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Short Text" }, "long_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Text" }, "quantity": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Quantity" }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unit" }, "unit_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Unit Price" }, "total_price": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Total Price" } }, "type": "object", "required": [ "section", "ordinal" ], "title": "GaebPositionOut" }, "GaebSectionSummaryOut": { "properties": { "name": { "type": "string", "title": "Name" }, "position_count": { "type": "integer", "title": "Position Count" } }, "type": "object", "required": [ "name", "position_count" ], "title": "GaebSectionSummaryOut" }, "GoNoGoCardOut": { "properties": { "rating_color": { "type": "string", "enum": [ "green", "yellow", "red" ], "title": "Rating Color" }, "rating_label": { "type": "string", "title": "Rating Label" }, "rating_summary": { "type": "string", "title": "Rating Summary" }, "recommendation": { "type": "string", "title": "Recommendation" }, "decision_rules": { "items": { "type": "string" }, "type": "array", "title": "Decision Rules" }, "technical_requirements": { "items": { "type": "string" }, "type": "array", "title": "Technical Requirements" }, "eligibility_evidence": { "items": { "type": "string" }, "type": "array", "title": "Eligibility Evidence" }, "award_criteria": { "items": { "type": "string" }, "type": "array", "title": "Award Criteria" }, "reference_fit": { "items": { "type": "string" }, "type": "array", "title": "Reference Fit" }, "deadline_status": { "type": "string", "title": "Deadline Status" }, "value_status": { "type": "string", "title": "Value Status" }, "buyer_cluster": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Buyer Cluster" }, "early_signals": { "items": { "type": "string" }, "type": "array", "title": "Early Signals" }, "open_questions": { "items": { "type": "string" }, "type": "array", "title": "Open Questions" }, "suggested_next_action": { "type": "string", "title": "Suggested Next Action" } }, "type": "object", "required": [ "rating_color", "rating_label", "rating_summary", "recommendation", "deadline_status", "value_status", "suggested_next_action" ], "title": "GoNoGoCardOut" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "HealthOut": { "properties": { "status": { "type": "string", "title": "Status" }, "sources": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Sources" } }, "type": "object", "required": [ "status", "sources" ], "title": "HealthOut" }, "PilotTenderStateIn": { "properties": { "status": { "type": "string", "enum": [ "new", "reviewed", "interesting", "rejected", "go", "clarify", "no_go" ], "title": "Status" }, "note": { "anyOf": [ { "type": "string", "maxLength": 5000 }, { "type": "null" } ], "title": "Note" }, "reference_project": { "anyOf": [ { "type": "string", "maxLength": 5000 }, { "type": "null" } ], "title": "Reference Project" }, "next_action": { "anyOf": [ { "type": "string", "maxLength": 5000 }, { "type": "null" } ], "title": "Next Action" } }, "type": "object", "required": [ "status" ], "title": "PilotTenderStateIn" }, "ProfileDeleteIn": { "properties": { "email": { "type": "string", "format": "email", "title": "Email" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "required": [ "email" ], "title": "ProfileDeleteIn" }, "PublicTenderOut": { "properties": { "id": { "type": "string", "title": "Id" }, "source": { "type": "string", "title": "Source" }, "source_url": { "type": "string", "title": "Source Url" }, "title": { "type": "string", "title": "Title" }, "buyer_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Buyer Name" }, "buyer_country": { "type": "string", "title": "Buyer Country" }, "buyer_nuts": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Buyer Nuts" }, "performance_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Performance Location" }, "performance_nuts": { "items": { "type": "string" }, "type": "array", "title": "Performance Nuts" }, "cpv_main": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cpv Main" }, "cpv_additional": { "items": { "type": "string" }, "type": "array", "title": "Cpv Additional" }, "published_at": { "type": "string", "format": "date-time", "title": "Published At" }, "deadline_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Deadline At" }, "estimated_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Estimated Value Eur" }, "languages": { "items": { "type": "string" }, "type": "array", "title": "Languages" }, "lot_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Lot Count" }, "award_criteria": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Award Criteria" }, "framework_agreement": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Framework Agreement" }, "gpa_covered": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Gpa Covered" }, "verticals": { "items": { "type": "string" }, "type": "array", "title": "Verticals" }, "relevance_score": { "type": "integer", "title": "Relevance Score" }, "summary": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Summary" } }, "type": "object", "required": [ "id", "source", "source_url", "title", "buyer_country", "published_at", "relevance_score" ], "title": "PublicTenderOut" }, "SignupIn": { "properties": { "email": { "type": "string", "format": "email", "title": "Email" }, "tier": { "type": "string", "enum": [ "free", "pro", "agent" ], "title": "Tier", "default": "free" }, "partner_tracking_code": { "anyOf": [ { "type": "string", "maxLength": 50, "pattern": "^[A-Za-z0-9_-]{1,50}$" }, { "type": "null" } ], "title": "Partner Tracking Code" } }, "type": "object", "required": [ "email" ], "title": "SignupIn" }, "SignupOut": { "properties": { "email": { "type": "string", "title": "Email" }, "tier": { "type": "string", "title": "Tier" }, "api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Api Key" }, "checkout_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Checkout Url" } }, "type": "object", "required": [ "email", "tier" ], "title": "SignupOut" }, "SourceStatusOut": { "properties": { "source": { "type": "string", "title": "Source" }, "implementation_status": { "type": "string", "enum": [ "live", "stub" ], "title": "Implementation Status" }, "last_attempt_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Attempt At" }, "last_success_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Success At" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Error" }, "fetched": { "type": "integer", "title": "Fetched", "default": 0 }, "stored": { "type": "integer", "title": "Stored", "default": 0 } }, "type": "object", "required": [ "source", "implementation_status" ], "title": "SourceStatusOut" }, "StatsOut": { "properties": { "total": { "type": "integer", "title": "Total" }, "by_source": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "By Source" }, "by_country": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "By Country" }, "last_7_days": { "type": "integer", "title": "Last 7 Days" } }, "type": "object", "required": [ "total", "by_source", "by_country", "last_7_days" ], "title": "StatsOut" }, "TenderOut": { "properties": { "id": { "type": "string", "title": "Id" }, "source": { "type": "string", "title": "Source" }, "source_id": { "type": "string", "title": "Source Id" }, "source_url": { "type": "string", "title": "Source Url" }, "title": { "type": "string", "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "buyer_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Buyer Name" }, "buyer_country": { "type": "string", "title": "Buyer Country" }, "buyer_nuts": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Buyer Nuts" }, "performance_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Performance Location" }, "performance_nuts": { "items": { "type": "string" }, "type": "array", "title": "Performance Nuts" }, "cpv_main": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cpv Main" }, "cpv_additional": { "items": { "type": "string" }, "type": "array", "title": "Cpv Additional" }, "published_at": { "type": "string", "format": "date-time", "title": "Published At" }, "deadline_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Deadline At" }, "estimated_value_eur": { "anyOf": [ { "type": "string", "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$" }, { "type": "null" } ], "title": "Estimated Value Eur" }, "procedure_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Procedure Type" }, "languages": { "items": { "type": "string" }, "type": "array", "title": "Languages" }, "lot_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Lot Count" }, "award_criteria": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Award Criteria" }, "framework_agreement": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Framework Agreement" }, "gpa_covered": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Gpa Covered" }, "selection_criteria": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selection Criteria" }, "requirements": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Requirements" }, "translation_de": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Translation De" }, "matched_cpv": { "items": { "type": "string" }, "type": "array", "title": "Matched Cpv" }, "verticals": { "items": { "type": "string" }, "type": "array", "title": "Verticals" }, "relevance_score": { "type": "integer", "title": "Relevance Score" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "source", "source_id", "source_url", "title", "buyer_country", "published_at", "relevance_score", "created_at", "updated_at" ], "title": "TenderOut" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "WebhookIn": { "properties": { "url": { "type": "string", "title": "Url" }, "cpv_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cpv Filter" }, "country_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Filter" }, "min_score": { "type": "integer", "title": "Min Score", "default": 0 }, "active": { "type": "boolean", "title": "Active", "default": true } }, "type": "object", "required": [ "url" ], "title": "WebhookIn" }, "WebhookOut": { "properties": { "id": { "type": "string", "title": "Id" }, "url": { "type": "string", "title": "Url" }, "cpv_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cpv Filter" }, "country_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Filter" }, "min_score": { "type": "integer", "title": "Min Score" }, "active": { "type": "boolean", "title": "Active" }, "last_fired_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Fired At" }, "failure_count": { "type": "integer", "title": "Failure Count" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "url", "min_score", "active", "failure_count", "created_at" ], "title": "WebhookOut" } }, "securitySchemes": { "oauth2ClientCredentials": { "type": "oauth2", "description": "OAuth 2.0 Client Credentials. client_id ist die Kennung eines API-Schluessels, client_secret der Schluessel selbst. Das Token laeuft nach einer Stunde ab und nennt seinen Umfang; wird der Schluessel widerrufen, traegt es sofort nicht mehr. Metadaten: /.well-known/oauth-authorization-server und /.well-known/oauth-protected-resource.", "flows": { "clientCredentials": { "tokenUrl": "/oauth/token", "scopes": { "tenders:read": "Read tender search, detail, source status and country coverage.", "fulltext:read": "Full text search across indexed notices. Requires a plan that permits it.", "profiles:read": "Read company profiles and their explained matches.", "webhooks:write": "Manage delivery webhooks." } } } }, "apiKeyBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "sk_", "description": "API-Schluessel als HTTP-Bearer-Token: 'Authorization: Bearer sk_...'. Kein anderer Header wird ausgewertet; eine Anfrage mit X-API-Key gilt als nicht angemeldet und laeuft im anonymen Limit. Schluessel gibt es kostenlos ueber POST /api/signup. Der Tarif des Schluessels (free, pro, agent) entscheidet ueber Limits und ueber den Zugang zu Volltextsuche, Export und Agent-Funktionen." } } }, "servers": [ { "url": "https://api.ausschreibungsagenten.de", "description": "Production API" }, { "url": "https://www.ausschreibungsagenten.de", "description": "Same-origin public aliases and proxy endpoints" } ], "security": [], "externalDocs": { "description": "Developer documentation", "url": "https://www.ausschreibungsagenten.de/entwickler" }, "x-deprecation-policy-url": "https://www.ausschreibungsagenten.de/api-policy.md", "x-sandbox": { "description": "Anonymous public preview endpoints are read-only and safe for integration tests.", "endpoints": [ "/api/tenders-public", "/api/source-status", "/api/countries" ] } }