GOSTART API

Baue auf GoStart.

Verbinde deine App mit der GoStart Plattform. Erstelle Rechnungen, verwalte Kunden, empfange Zahlungs-Webhooks – alles über eine saubere REST API.

API-Key anfordern →Endpoints ansehen

REST / JSONBearer AuthWebhooksSchweizer Server

ENDPOINTS

Was du über die API machen kannst.

Alle Ressourcen sind über https://api.gostart.ch/v1/ erreichbar.

KUNDEN

GET /customers
POST /customers
PATCH /customers/:id
DELETE /customers/:id

RECHNUNGEN

GET /invoices
POST /invoices
GET /invoices/:id/pdf
POST /invoices/:id/send

OFFERTEN

GET /quotes
POST /quotes
POST /quotes/:id/accept
GET /quotes/:id/pdf

PROJEKTE

GET /projects
POST /projects
GET /projects/:id/tasks
POST /time-entries

ZAHLUNGEN

GET /payments
POST /payment-links
GET /payments/:id
POST /refunds

WEBHOOKS

invoice.paid
invoice.overdue
customer.created
payment.received

Beispiel: Rechnung erstellen

JavaScript

const res = await fetch('https://api.gostart.ch/v1/invoices', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer gs_live_sk_••••••••',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customer_id: 'cus_abc123',
    items: [
      { description: 'Webdesign Paket S', quantity: 1, unit_price: 180000 }
    ],
    currency: 'CHF',
    due_days: 30
  })
});

const invoice = await res.json();
// invoice.id        → 'inv_8k2m'
// invoice.pdf_url   → 'https://app.gostart.ch/invoices/inv_8k2m.pdf'
// invoice.qr_bill   → Base64-Bild des QR-Einzahlungsscheins

API-ZUGANG

API-Key anfordern.

Füll das Formular aus – du erhältst deinen API-Key innerhalb von 24 Stunden per E-Mail.

HÄUFIGE FRAGEN

Gut zu wissen.

Ist die API kostenlos?

Ja. API-Zugang ist für alle GoStart-Accounts inklusive. Rate Limits gelten je nach Plan.

Welche Authentifizierung wird verwendet?

Bearer Token (API-Key) für einfache Integrationen, OAuth 2.0 für Apps die im Namen anderer Nutzer handeln.

Wie schnell bekomme ich meinen API-Key?

Innerhalb von 24 Stunden nach dem Absenden des Formulars. Wir schauen uns jede Anfrage kurz an, um sicherzustellen, dass der Anwendungsfall zur Plattform passt.

Kann ich Apps für andere GoStart-Nutzer bauen?

Ja. Mit OAuth 2.0 kannst du eine App bauen, in der sich GoStart-Nutzer einloggen und dir Zugriff auf ihre Daten erteilen. Schreib uns deinen Use Case ins Formular.

Fragen zur API?

Schreib uns – wir helfen dir beim Einstieg und besprechen deinen Use Case.

[email protected] →