Skip to main content

Quickstart

Igdrasil API requests are authenticated and most product data is company-scoped. Start with read-only calls before testing writes.

1. Set client values​

export IGDRASIL_API_BASE_URL="https://accounting.igdrasil.se"
export IGDRASIL_TOKEN="<bearer-token>"
export IGDRASIL_COMPANY_ID="<company-id>"

Use the base URL for the environment you are targeting.

2. Check service health​

curl -fsS "$IGDRASIL_API_BASE_URL/api/v1/health"

3. Make an authenticated user call​

curl -fsS "$IGDRASIL_API_BASE_URL/api/v1/profile" \
  -H "Authorization: Bearer $IGDRASIL_TOKEN"

4. Make a company-scoped call​

curl -fsS "$IGDRASIL_API_BASE_URL/api/v1/companies/$IGDRASIL_COMPANY_ID" \
  -H "Authorization: Bearer $IGDRASIL_TOKEN" \
  -H "X-Company-Id: $IGDRASIL_COMPANY_ID"

5. Capture diagnostics​

Log the response status, response body, and X-Request-Id for failed requests. Use write endpoints only after you have confirmed authentication and company scope in the target environment.

Read Authentication, Request IDs, and the API Reference next.