Legacy Migration

Legacy Migration

Endpoints

IntroductionPOST/legacy-migration/authPOST/legacy-migration/jobsGET/legacy-migration/jobsGET/legacy-migration/jobs/{id}

The Legacy Migration object

object

Attributes

idstring

Job ID

Other attributesExpand all

legacy_org_idstring

environmentstring

entity_idstringnullable

statusstring

stepstringnullable

step_numbernumber

total_stepsnumber

progress_detailstringnullable

errorstringnullable

created_atstring

started_atstringnullable

completed_atstringnullable

Examplejson

Copy

{
  "id": "mig_507f1f77bcf86cd799439011",
  "legacy_org_id": "legacy_org_abc123",
  "environment": "sandbox",
  "entity_id": null,
  "status": "pending",
  "step": "Queued",
  "step_number": 0,
  "total_steps": 8,
  "progress_detail": "Migration job is waiting to start.",
  "error": null,
  "created_at": "2024-01-01T00:00:00.000Z",
  "started_at": null,
  "completed_at": null
}

---

Authenticate with legacy API

POST/legacy-migration/auth

Authenticate with legacy Space Invoices credentials and get a list of owned organizations.

Request

Header parameters

account_idstringoptional

Account Id on which the request is made. Optional if user is part of only one account.

Body parameters

emailstring<email>required

Email for legacy Space Invoices account

passwordstringrequired

Password for legacy Space Invoices account

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/legacy-migration/auth" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "legacy-account-password"
  }'

Response

Returns

organizationsarray of objectsShow child attributes

legacy_session_idstring

json

Copy

{
  "organizations": [
    {
      "id": "legacy_org_abc123",
      "name": "Acme d.o.o.",
      "country": "SI",
      "tax_number": "SI12345678",
      "created_at": "2020-05-15T10:00:00.000Z",
      "already_migrated": false,
      "migrated_environment": null
    }
  ],
  "legacy_session_id": "lm_session_abc123"
}

---

Create migration job

POST/legacy-migration/jobs

Create a new legacy migration job.

Request

Header parameters

account_idstringoptional

Account Id on which the request is made. Optional if user is part of only one account.

Body parameters

legacy_org_idstringrequired

Legacy organization ID to migrate

legacy_session_idstringrequired

Temporary legacy session ID created after legacy authentication

environmentstringrequired

Target environment

Possible values: "live", "sandbox"

Other parametersExpand all

confirm_unsupported_databooleanoptional

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/legacy-migration/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "legacy_org_id": "legacy_org_abc123",
    "legacy_session_id": "lm_session_abc123",
    "environment": "sandbox"
  }'

Example:

Start sandbox migrationConfirm unsupported data

---

List migration jobs

GET/legacy-migration/jobs

List all migration jobs for the current account.

Request

Header parameters

account_idstringoptional

Account Id on which the request is made. Optional if user is part of only one account.

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/legacy-migration/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

Response

Returns

dataarray of objectsShow child attributes

json

Copy

{
  "data": [
    {
      "id": "mig_507f1f77bcf86cd799439011",
      "legacy_org_id": "legacy_org_abc123",
      "environment": "sandbox",
      "entity_id": null,
      "status": "pending",
      "step": "Queued",
      "step_number": 0,
      "total_steps": 8,
      "progress_detail": "Migration job is waiting to start.",
      "error": null,
      "created_at": "2024-01-01T00:00:00.000Z",
      "started_at": null,
      "completed_at": null
    }
  ]
}

---

Get migration job status

GET/legacy-migration/jobs/{id}

Get status and progress of a migration job.

Request

Header parameters

account_idstringoptional

Account Id on which the request is made. Optional if user is part of only one account.

Path parameters

idstringrequired

Migration job ID

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl "https://eu.spaceinvoices.com/legacy-migration/jobs/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

Response

Returns

idstring

Job ID

Other parametersExpand all

legacy_org_idstring

environmentstring

entity_idstringnullable

statusstring

stepstringnullable

step_numbernumber

total_stepsnumber

progress_detailstringnullable

errorstringnullable

created_atstring

started_atstringnullable

completed_atstringnullable

json

Copy

{
  "id": "mig_507f1f77bcf86cd799439011",
  "legacy_org_id": "legacy_org_abc123",
  "environment": "sandbox",
  "entity_id": null,
  "status": "pending",
  "step": "Queued",
  "step_number": 0,
  "total_steps": 8,
  "progress_detail": "Migration job is waiting to start.",
  "error": null,
  "created_at": "2024-01-01T00:00:00.000Z",
  "started_at": null,
  "completed_at": null
}

Example:

PendingCompleted

---