Skip to main content
GET https://app.vern.so/api/v1/sources
Returns the sources in your account — the migration definitions you’ve authored in the Vern UI. Use it to build a source picker in your own product so each customer can choose which system they’re migrating from, then pass the chosen id as source when you provision a company.
Preview. Part of the Migration API — in active design and not yet generally available; the shapes below may change. Until this ships, read source IDs from Settings → Sources in the dashboard. See the overview.

​
Authentication

Requires an x-api-key header. See Authentication.

​
Response

200 OK 
{
  "sources": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "Salesforce",
      "logo_url": "https://logo.clearbit.com/salesforce.com"
    }
  ]
}
​
id
string (uuid)
The source’s UUID. Pass it as source when you provision a company.
​
name
string
The source’s display name — the system you migrate from (e.g. “Salesforce”).
​
logo_url
string | null
A logo for the source, suitable for rendering in your picker. null if none is set.
Sources and templates are independent lists. A source defines the import plan and export writer; templates are the importable objects, shared across your account. List them separately and let your customer pick each — see List templates.

​
Errors

StatusMeaning
401API key missing or invalid.
429Rate limit hit — back off and retry.
500Server error.

​
Example

curl https://app.vern.so/api/v1/sources \
  -H "x-api-key: $VERN_API_KEY"

​
Next