Reports an account (or loan record from your organization) to CreditRegistry.
POST
api.creditregistry.com/nigeria/AutoCred/test/v8/api/AddUpdateAccount
Accounts
Request.Account.IndividualAccountOwners and/or
Request.Account.BusinessAccountOwners. Alternately, for account owners that your organization has
previously reported to CreditRegistry, specify their customer numbers via
Request.Account.AccountOwnerCustomerNumbers.Request.Account.IndividualGuarantors and/or Request.Account.BusinessGuarantors. Alternately,
for guarantors that your organization has previously reported to CreditRegistry, specify their
customer numbers via
Request.Account.GuarantorCustomerNumbers.the given customer numbers must already exist at CreditRegistry otherwise the upload is rejected.
If uncertain, specify complete account owner and guarantor information instead.
DissociateAccount endpoint.Response.Success will be true;
otherwise, the request is rejected,
Response.Success will be false, and Response.Errors will
contain reasons for the rejection.
Response.UploadID, with the GetAccountUploadStatus endpoint to query the status of this request.Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'api.creditregistry.com/nigeria/AutoCred/test/v8/api/AddUpdateAccount' \
--header 'Content-Type: application/json' \
--data-raw '{
"SessionCode": "string",
"Account": {
"AccountNumber": "string",
"AccountStatus": "Performing",
"AccountStatusDate": "2019-08-24T14:15:22Z",
"Balance": 0,
"DaysInArrears": 0,
"BalanceDate": "2019-08-24T14:15:22Z",
"Payment": 0,
"PaymentDate": "2019-08-24T14:15:22Z",
"CreditorNotes": "string",
"AccountNotes": "string",
"LegalStatus": "None",
"LegalStatusDate": "2019-08-24T14:15:22Z",
"DateOpened": "2019-08-24T14:15:22Z",
"LoanPrincipalCreditLimit": 0,
"MinimumInstallment": 0,
"CurrencyType": "A00",
"AccountType": "AA00_InvalidAccountType",
"Term": "string",
"Purpose": "string",
"RepaymentFrequency": "Daily",
"MaturityDate": "2019-08-24T14:15:22Z",
"BranchName": "string",
"BranchAddress": "string",
"SortCode": "string",
"InterestType": "Fixed",
"InterestRate": 0,
"IndividualAccountOwners": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"FirstName": "string",
"Surname": "string",
"OtherNames": [
"string"
],
"DateOfBirth": "2019-08-24T14:15:22Z",
"BVN": "string",
"NationalID": "string",
"DriverLicenseNo": "string",
"TaxID": "string",
"PassportNo": "string",
"VoterID": "string",
"Gender": "Female",
"MaritalStatus": "Single",
"AccommodationStatus": "Rent",
"MonthlyRentMortgage": 0,
"EmploymentStatus": "Unemployed",
"AnnualIncome": 0,
"AssetValue": 0,
"EducationLevel": "Unknown",
"CountryOfNationality": "A0_InvalidCountry",
"NumberOfDependants": 0,
"Pictures": [
{
"PictureBase64String": "string",
"PictureFormat": "JPEG"
}
],
"Employments": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"Employer": "string",
"JobTitle": "string",
"Occupation": "string",
"Manager": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z",
"AnnualIncome": 0
}
]
}
],
"IndividualGuarantors": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"FirstName": "string",
"Surname": "string",
"OtherNames": [
"string"
],
"DateOfBirth": "2019-08-24T14:15:22Z",
"BVN": "string",
"NationalID": "string",
"DriverLicenseNo": "string",
"TaxID": "string",
"PassportNo": "string",
"VoterID": "string",
"Gender": "Female",
"MaritalStatus": "Single",
"AccommodationStatus": "Rent",
"MonthlyRentMortgage": 0,
"EmploymentStatus": "Unemployed",
"AnnualIncome": 0,
"AssetValue": 0,
"EducationLevel": "Unknown",
"CountryOfNationality": "A0_InvalidCountry",
"NumberOfDependants": 0,
"Pictures": [
{
"PictureBase64String": "string",
"PictureFormat": "JPEG"
}
],
"Employments": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"Employer": "string",
"JobTitle": "string",
"Occupation": "string",
"Manager": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z",
"AnnualIncome": 0
}
]
}
],
"BusinessAccountOwners": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"Name": "string",
"RCNumber": "string",
"TaxID": "string",
"DateOfIncorporation": "2019-08-24T14:15:22Z",
"AnnualRevenue": 0,
"AssetValue": 0,
"Website": "string",
"TypeOfBusiness": "CommercialBank",
"CorporateOfficers": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"FirstName": "string",
"Surname": "string",
"OtherNames": [
"string"
],
"DateOfBirth": "2019-08-24T14:15:22Z",
"BVN": "string",
"NationalID": "string",
"DriverLicenseNo": "string",
"TaxID": "string",
"PassportNo": "string",
"VoterID": "string",
"Gender": "Female",
"MaritalStatus": "Single",
"AccommodationStatus": "Rent",
"MonthlyRentMortgage": 0,
"EmploymentStatus": "Unemployed",
"AnnualIncome": 0,
"AssetValue": 0,
"EducationLevel": "Unknown",
"CountryOfNationality": "A0_InvalidCountry",
"NumberOfDependants": 0,
"Pictures": [
{
"PictureBase64String": "string",
"PictureFormat": "JPEG"
}
],
"Employments": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"Employer": "string",
"JobTitle": "string",
"Occupation": "string",
"Manager": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z",
"AnnualIncome": 0
}
],
"CorporateOfficerType": "Officer",
"CorporateOfficerJobPositionTitle": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z"
}
]
}
],
"BusinessGuarantors": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"Name": "string",
"RCNumber": "string",
"TaxID": "string",
"DateOfIncorporation": "2019-08-24T14:15:22Z",
"AnnualRevenue": 0,
"AssetValue": 0,
"Website": "string",
"TypeOfBusiness": "CommercialBank",
"CorporateOfficers": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"ContactPhoneNumbers": [
"string"
],
"OfficePhoneNumbers": [
"string"
],
"FaxNumbers": [
"string"
],
"ContactEmailAddresses": [
"string"
],
"OfficeEmailAddresses": [
"string"
],
"CustomerNumber": "string",
"FirstName": "string",
"Surname": "string",
"OtherNames": [
"string"
],
"DateOfBirth": "2019-08-24T14:15:22Z",
"BVN": "string",
"NationalID": "string",
"DriverLicenseNo": "string",
"TaxID": "string",
"PassportNo": "string",
"VoterID": "string",
"Gender": "Female",
"MaritalStatus": "Single",
"AccommodationStatus": "Rent",
"MonthlyRentMortgage": 0,
"EmploymentStatus": "Unemployed",
"AnnualIncome": 0,
"AssetValue": 0,
"EducationLevel": "Unknown",
"CountryOfNationality": "A0_InvalidCountry",
"NumberOfDependants": 0,
"Pictures": [
{
"PictureBase64String": "string",
"PictureFormat": "JPEG"
}
],
"Employments": [
{
"StreetAddress1": "string",
"StreetAddress2": "string",
"City": "string",
"StateProvince": "string",
"ZipPostalCode": "string",
"LGA": "string",
"Country": "string",
"Employer": "string",
"JobTitle": "string",
"Occupation": "string",
"Manager": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z",
"AnnualIncome": 0
}
],
"CorporateOfficerType": "Officer",
"CorporateOfficerJobPositionTitle": "string",
"StartDate": "2019-08-24T14:15:22Z",
"EndDate": "2019-08-24T14:15:22Z"
}
]
}
],
"AccountOwnerCustomerNumbers": [
"string"
],
"GuarantorCustomerNumbers": [
"string"
],
"AccountHistory": [
{
"AccountNumber": "string",
"AccountStatus": "Performing",
"AccountStatusDate": "2019-08-24T14:15:22Z",
"Balance": 0,
"DaysInArrears": 0,
"BalanceDate": "2019-08-24T14:15:22Z",
"Payment": 0,
"PaymentDate": "2019-08-24T14:15:22Z",
"CreditorNotes": "string",
"AccountNotes": "string",
"LegalStatus": "None",
"LegalStatusDate": "2019-08-24T14:15:22Z",
"AccountHistoryID": "string",
"SubscriberID": "string"
}
],
"Collaterals": [
{
"Collateral": "string",
"CollateralType": "None",
"CollateralValue": 0,
"CollateralCurrency": "A00",
"CollateralDate": "2019-08-24T14:15:22Z"
}
],
"AccountHistoryID": "string",
"SubscriberID": "string"
}
}'Response Response Example
{
"Success": true,
"Errors": [
"string"
],
"StatusCode": 0,
"Message": "string",
"UploadID": "string",
"UploadDate": "2019-08-24T14:15:22Z",
"UploadType": "PersonAddUpdate",
"UploadTypeDescription": "string",
"AgentID": "string",
"SubscriberID": "string",
"UploadStatusList": [
{
"TransactionID": "string",
"TransactionDate": "2019-08-24T14:15:22Z",
"ProcessingStatus": "UploadReceived",
"ProcessingStatusDescription": "string",
"ProcessingStatusMessage": "string",
"ProcessingMessages": [
"string"
]
}
]
}Modified at 2025-11-29 04:37:26