Migration API
Endpoint Index
Action | Endpoint |
---|---|
Start Migration | POST /migration/{tenantLocator}/migrations |
Start Migrations for an Existing Account | POST /migration/{tenantLocator}/migrations/accounts/{accountLocator} |
Resume a Paused Migration | PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/resume |
Attempt to Recover System Error Items for a Migration | PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/recover |
Pause a Running Migration | PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/pause |
Patch an Existing Migration Request | PATCH /migration/{tenantLocator}/migrations/{migrationLocator} |
Get Migration Summary | GET /migration/{tenantLocator}/migrations/{migrationLocator} |
Get Migration Mappings | GET /migration/{tenantLocator}/migrations/{migrationLocator}/mappings/list |
Get Migration Mappings for Account | GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/{accountLocator}/mappings |
Get Account Migrations | GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/{accountLocator} |
List Account Migrations | GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/list |
Get Migration Failures | GET /migration/{tenantLocator}/migrations/{migrationLocator}/failures/list |
Migration Management
POST /migration/{tenantLocator}/migrations
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
Request:AccountMigrationRequest[]
Response:MigrationResponse
Security Group:migration  Permission:write
AccountMigrationRequest
¶requiredaccountData AccountMigrationDatadefaultCreatedBy uuiddisbursements DisbursementMigrationRequest[]invoices InvoiceMigrationRequest[]payments PaymentMigrationRequest[]policies PolicyMigrationRequest[]
PolicyMigrationRequest
¶requiredproductName stringautoRenewalPlanName stringdelinquencyPlanName stringdurationBasis Enum years | months | weeks | days | hoursbillingLevel Enum account | inherit | policyid stringpreferences PreferencesResponsecreatedAt datetimecreatedBy uuidstaticData map<string,object>terms TermMigrationRequest[]optionalcurrency string?timezone string?
TransactionMigrationRequest
¶requiredissuedTime datetimetransactionType stringcreatedAt datetimecreatedBy uuidinstallments InstallmentMigrationRequest[]optionalsegment SegmentMigrationRequest?
PaymentMigrationRequest
¶requiredid stringpaymentTime datetimepaymentType stringdata map<string,object>createdBy uuidpaymentItems PaymentItemMigrationRequest[]optionalcurrency string?
AccountMigrationData
¶requiredautoRenewalPlanName stringdelinquencyPlanName stringexcessCreditPlanName stringshortfallTolerancePlanName stringaccountType stringbillingLevel Enum account | inherit | policyid stringpreferences PreferencesResponsedata map<string,object>createdAt datetimecreatedBy uuid
InvoiceMigrationRequest
¶requiredstartTime datetimeendTime datetimedueTime datetimegenerateTime datetimeid stringoptionalcurrency string?timezone string?
DisbursementMigrationRequest
¶requireddisbursementTime datetimedisbursementType stringid stringdata map<string,object>sources CreditItemMigrationRequest[]optionalcurrency string?
CreditItemMigrationRequest
¶requiredamount number
PaymentItemMigrationRequest
¶requiredamount numberinvoiceId string
SegmentMigrationRequest
¶requiredstartTime datetimerootElement ElementMigrationRequestsegmentType Enum coverage | gap
InstallmentMigrationRequest
¶requiredstartTime datetimedueTime datetimegenerateTime datetimeid stringinvoiceId string
InstallmentItemMigrationRequest
¶requiredamount numberid stringinstallmentNumber int
ElementMigrationRequest
¶requiredelementType stringid stringdata map<string,object>charges ChargeMigrationRequest[]coverageTerms map<string,string>elements ElementMigrationRequest[]
ChargeMigrationRequest
¶requiredchargeType stringrate numberreferenceRate numbertag stringinstallmentItems InstallmentItemMigrationRequest[]
TermMigrationRequest
¶requiredstartTime datetimeendTime datetimetransactions TransactionMigrationRequest[]
MigrationResponse
¶requiredlocator locatormigrationState Enum submitted | processing | paused | finished | failed | errormigrationType Enum fullMigration | addAccountItemsprocessedAccounts inttotalAccounts int
ErrorDetailsResponse
¶requirederrors ValidationResultoriginalId string
POST /migration/{tenantLocator}/migrations/accounts/{accountLocator}
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
accountLocator | path | locator | required |
Request:MigrationRequest
Response:MigrationResponse
Security Group:migration  Permission:write
MigrationRequest
¶requireddefaultCreatedBy uuiddisbursements DisbursementMigrationRequest[]invoices InvoiceMigrationRequest[]payments PaymentMigrationRequest[]policies PolicyMigrationRequest[]
PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/resume
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
Response:void
Security Group:migration  Permission:write
PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/recover
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
Response:void
Security Group:migration  Permission:write
PATCH /migration/{tenantLocator}/migrations/{migrationLocator}/pause
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
Response:void
Security Group:migration  Permission:write
Note
In-flight transactions will be completed before the migration pauses.
PATCH /migration/{tenantLocator}/migrations/{migrationLocator}
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
Request:PatchAccountMigrationRequest
Response:MigrationFailuresResponse
Security Group:migration  Permission:write
PatchAccountMigrationRequest
¶requiredaccountLocator locatordefaultCreatedBy uuiddisbursements map<string,DisbursementMigrationRequest>invoices map<string,InvoiceMigrationRequest>payments map<string,PaymentMigrationRequest>policies map<string,PolicyMigrationRequest>optionalaccountData AccountMigrationData?
MigrationFailuresResponse
¶requiredaccountLocator locatoraccountOriginalId stringdisbursements map<string,ErrorDetailsResponse>invoices map<string,ErrorDetailsResponse>payments map<string,ErrorDetailsResponse>policies map<string,ErrorDetailsResponse>optionalaccountError ErrorDetailsResponse?
Migration Information
GET /migration/{tenantLocator}/migrations/{migrationLocator}
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
Response:MigrationResponse
Security Group:migration  Permission:read
Returns per-account mappings of system locators to original IDs
GET /migration/{tenantLocator}/migrations/{migrationLocator}/mappings/list
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
offset | query | int? | optional |
count | query | int? | optional |
Security Group:migration  Permissions:read,list
AccountMigrationIdMappingsListResponse
¶requiredlistCompleted boolean
ListPageResponseAccountMigrationIdMappings
¶requiredlistCompleted boolean
AccountMigrationIdMappingsResponse
¶requiredaccountLocator locatormigrationLocator locatororiginalAccountId stringdisbursements map<string,MappingObject>invoices map<string,MappingObject>payments map<string,MappingObject>policies map<string,MappingObject>
Fetches mappings of original IDs to system locators for an account
GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/{accountLocator}/mappings
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
accountLocator | path | locator | required |
Response:AccountMigrationIdMappingsResponse
Security Group:migration  Permission:read
GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/{accountLocator}
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
accountLocator | path | locator | required |
Response:AccountMigrationResponse
Security Group:migration  Permission:read
AccountMigrationResponse
¶requiredaccountMigrationState Enum pending | processing | error | failed | completederrorItems intlastUpdated datetimeprocessedItems inttotalItems intoptionalaccountLocator locator?
GET /migration/{tenantLocator}/migrations/{migrationLocator}/accounts/list
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
offset | query | int? | optional |
count | query | int? | optional |
Security Group:migration  Permissions:read,list
ListPageResponseAccountMigrationResponse
¶requiredlistCompleted booleanitems AccountMigrationResponse[]
GET /migration/{tenantLocator}/migrations/{migrationLocator}/failures/list
Request Parameters:
Name | Position | Type | Required |
---|---|---|---|
tenantLocator | path | uuid | required |
migrationLocator | path | locator | required |
offset | query | int? | optional |
count | query | int? | optional |
Security Group:migration  Permissions:read,list
ListPageResponseMigrationFailuresResponse
¶requiredlistCompleted booleanitems MigrationFailuresResponse[]