{"openapi":"3.1.0","info":{"title":"SignalDesk","version":"0.1.0","description":"Señales de compra y reuniones para empresas B2B en España y Latinoamérica, pago por uso, pensado para agentes de IA y para personas. Phase 0: only POST /api/public/waitlist works. Operations marked x-status: early-access are planned and not open yet; they may change."},"servers":[{"url":"https://signaldesk.lat"}],"paths":{"/api/public/waitlist":{"post":{"operationId":"join_waitlist","summary":"Join the waitlist (works today)","x-status":"available","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistRequest"}}}},"responses":{"200":{"description":"Already registered (idempotent)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistResponse"}}}},"201":{"description":"Registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistResponse"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/signals/search":{"post":{"x-status":"early-access","operationId":"search_signals","summary":"Search buying signals (charged per delivered signal)","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["country"],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"},"sector":{"type":"string"},"signal_type":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"company_id":{"type":"string"},"type":{"type":"string"},"summary":{"type":"string"},"detected_at":{"type":"string","format":"date-time"}}}},"charged_usd":{"type":"number"},"balance_usd":{"type":"number"}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Saldo insuficiente / Insufficient balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}},"/api/v1/companies/{company_id}":{"get":{"x-status":"early-access","operationId":"get_company","summary":"Get a company profile (charged per profile)","security":[{"bearerAuth":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"country":{"type":"string"},"website":{"type":"string","format":"uri"},"sector":{"type":"string"},"charged_usd":{"type":"number"},"balance_usd":{"type":"number"}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Saldo insuficiente / Insufficient balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/balance":{"get":{"x-status":"early-access","operationId":"get_balance","summary":"Get prepaid credit balance (free)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"balance_usd":{"type":"number"},"currency":{"type":"string","const":"USD"}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/balance/top-up":{"post":{"x-status":"early-access","operationId":"top_up","summary":"Create a Mercado Pago top-up link","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount_usd"],"properties":{"amount_usd":{"type":"number","exclusiveMinimum":0}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"top_up_url":{"type":"string","format":"uri"},"amount_usd":{"type":"number"},"provider":{"type":"string","const":"mercadopago"}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key of a verified account (early access)."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequired":{"type":"object","required":["error","top_up_url"],"properties":{"error":{"type":"string","const":"payment_required"},"message":{"type":"string"},"balance_usd":{"type":"number"},"required_usd":{"type":"number"},"top_up_url":{"type":"string","format":"uri"}}},"WaitlistRequest":{"type":"object","required":["email","interest","kind","consent"],"properties":{"email":{"type":"string","format":"email"},"company":{"type":"string","maxLength":120},"website":{"type":"string","format":"uri","maxLength":200},"role":{"type":"string","maxLength":120},"interest":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["senales","fichas","reuniones"]},"description":"What you want to buy."},"kind":{"type":"string","enum":["agente","persona"],"description":"Whether you are an AI agent or a person."},"consent":{"type":"boolean","const":true,"description":"Explicit consent to receive the launch notice."}}},"WaitlistResponse":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["registered","already_registered"]}}}}}}