How to Use AutoCred8 API

AutoCred API v8
    AutoCred API v8
    • Agents
      • Login and get session code to use for subsequent API calls.
      • Logout of the session with the specified session code.
      • Reset password for agent with specified details.
      • Update password for agent with specified details.
      • Get login timeout (session codes become invalid after this period).
    • Customers
      • Returns data for product ID 8100 (i.e. summary customer information using specified search parameters).
      • Returns data for product ID 8102 (i.e. detailed customer information using specified search parameters).
    • Accounts
      • Reports an account (or loan record from your organization) to CreditRegistry.
      • Updates or corrects account history record at CreditRegistry.
      • Deletes wrong or invalid account history records at CreditRegistry.
      • Dissociates account owner(s) and/or guarantors from an account.
      • Gets an account (or loan record for your organization) from CreditRegistry.
      • Gets status of an upload using the UploadID value returned from a successful data submission API call.
    • Businesses
      • Reports your business/corporate account owners to CreditRegistry.
      • Get a business/corporate customer record you uploaded to CreditRegistry.
      • Gets status of an upload using the UploadID value returned from a successful data submission API call.
    • Persons
      • Reports your person/individual account owners to CreditRegistry.
      • Get a person/individual customer record you uploaded to CreditRegistry.
      • Gets status of an upload using the UploadID value returned from a successful data submission API call.
    • Reports
      • Returns data for product ID 8200 (i.e. Account data + PDF Report).
      • Returns data for product ID 8201 (i.e. Account data + SMARTScore + Score Factor).
      • Returns data for product ID 8202 (i.e. SMARTScore + Score Factor).
      • Returns data for product ID 8203 (i.e. Account data + SMARTScore + Score Factor + PDF Report).
      • Returns data for product ID 8204 (i.e. Account data).
      • Returns data for product ID 8300 (i.e. PDF Report).
      • Returns data for product ID 8301 (i.e. credit performance check to determine whether or not a customer is "performing").
      • Returns data for product ID 8302 (i.e. SBCs + Account Summaries + Performance Summary).
      • Returns data for product ID 8303 (i.e. SBCs + Account Summaries + Performance Summary + Account data).
      • Returns data for product ID 8304 (i.e. SBCs + Account Summaries + Performance Summary + SMARTScore + Score Factor).
      • Returns data for product ID 8305 (i.e. SBCs + Account Summaries + Performance Summary + Account data + SMARTScore + Score Factor).
      • Returns data for product ID 8306 (i.e. SBCs + Account Summaries + Performance Summary + SMARTScore + Score Factor + PDF Report).
      • Returns data for product ID 8400 (i.e. customer payment profile which indicates payment performance over the previous months).
    • Schemas
      • AccommodationStatus
      • AccountDataResult
      • AccountHistoryBaseReq
      • AccountHistoryIdentity
      • AccountHistoryUpdateReq
      • AccountStatus
      • AccountSummaryByCurrencyResult
      • AccountType
      • AddUpdateAccountHistoryRequest
      • AddUpdateAccountRequest
      • AddUpdateBusinessRequest
      • AddUpdatePersonRequest
      • BaseResponse
      • BusinessType
      • BusinessWithRelationReq
      • ClosedAccountsResult
      • Collateral
      • CollateralAccountHistoryBase
      • CollateralCollateralAccountHistoryBasePicturePicturePersonBusinessWithRelationReqAccount
      • CollateralReq
      • CollateralReqAccountHistoryBaseReqAccountReq
      • CollateralType
      • CorporateOfficerReq
      • CorporateOfficerType
      • CountryCode
      • CreditorsResult
      • CurrencyType
      • CustomerDetail
      • CustomerPaymentProfile
      • CustomerPerformance
      • CustomerSummary
      • DeleteAccountHistoryRequest
      • DelinquentAccountsResult
      • DerogatoryAccountsResult
      • DissociateAccountRequest
      • EducationLevel
      • Employment
      • EmploymentStatus
      • EnquiryReason
      • FamilyRelationReq
      • FamilyRelationType
      • FindDetailRequest
      • FindDetailResponse
      • FindSummaryRequest
      • FindSummaryResponse
      • Gender
      • GetAccountRequest
      • GetAccountResponse
      • GetBusinessRequest
      • GetPersonRequest
      • GetReport200Request
      • GetReport200Response
      • GetReport201Request
      • GetReport201Response
      • GetReport202Request
      • GetReport202Response
      • GetReport203Request
      • GetReport203Response
      • GetReport204Request
      • GetReport204Response
      • GetReport300Request
      • GetReport300Response
      • GetReport301Request
      • GetReport301Response
      • GetReport302Request
      • GetReport302Response
      • GetReport303Request
      • GetReport303Response
      • GetReport304Request
      • GetReport304Response
      • GetReport305Request
      • GetReport305Response
      • GetReport306Request
      • GetReport306Response
      • GetReport400Request
      • GetReport400Response
      • InquiryHistoryResult
      • InquiryHistorySummaryResult
      • InterestType
      • LegalStatus
      • LoginRequest
      • LoginResponse
      • LogoutRequest
      • MaritalStatus
      • NoMatchReportSetting
      • PaymentProfileCustomer
      • PaymentProfileInfo
      • PerformanceSummaryResult
      • PerformingAccountsResult
      • PersonReq
      • PersonWithRelationReq
      • Picture
      • PictureCorporateOfficer
      • PictureFamilyRelation
      • PictureFormat
      • PicturePerson
      • PicturePictureCorporateOfficerBusinessWithRelation
      • PicturePictureCorporateOfficerBusinessWithRelationGetBusinessResponse
      • PicturePictureFamilyRelationRelatedBusinessPersonWithRelation
      • PicturePictureFamilyRelationRelatedBusinessPersonWithRelationGetPersonResponse
      • PictureReq
      • ProcessingStatus
      • RelatedBusiness
      • RelatedBusinessReq
      • RepaymentFrequencyType
      • ResetPasswordRequest
      • SBCResult
      • SMARTScoreResult
      • ScoreFactorResult
      • UnknownStatusAccountsResult
      • UpdatePasswordRequest
      • UploadResponse
      • UploadStatus
      • UploadStatusRequest
      • UploadStatusResponse
      • UploadType
      • WrittenOffAccountsResult

    AddUpdateAccountRequest

    Request for Accounts.AddUpdate.

    {
        "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": [
                {
                    "IsInCompleteAddress": true,
                    "StreetAddress1": "string",
                    "StreetAddress2": "string",
                    "City": "string",
                    "StateProvince": "string",
                    "ZipPostalCode": "string",
                    "LGA": "string",
                    "Country": "string",
                    "ContactPhoneNumbers": [
                        "string"
                    ],
                    "OfficePhoneNumbers": [
                        "string"
                    ],
                    "FaxNumbers": [
                        "string"
                    ],
                    "ContactEmailAddresses": [
                        "string"
                    ],
                    "OfficeEmailAddresses": [
                        "string"
                    ],
                    "IsContactInfoEmpty": true,
                    "IsContactPhoneNumberEmpty": true,
                    "IsOfficePhoneNumberEmpty": true,
                    "IsContactEmailAddressEmpty": true,
                    "IsOfficeEmailAddressEmpty": true,
                    "Name": "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",
                            "PictureFormatDescription": "string"
                        }
                    ],
                    "Employments": [
                        {
                            "IsInCompleteAddress": true,
                            "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
                        }
                    ],
                    "GenderDescription": "string",
                    "MaritalStatusDescription": "string",
                    "EducationLevelDescription": "string",
                    "EmploymentStatusDescription": "string",
                    "AccommodationStatusDescription": "string",
                    "CountryOfNationalityDescription": "string"
                }
            ],
            "IndividualGuarantors": [
                {
                    "IsInCompleteAddress": true,
                    "StreetAddress1": "string",
                    "StreetAddress2": "string",
                    "City": "string",
                    "StateProvince": "string",
                    "ZipPostalCode": "string",
                    "LGA": "string",
                    "Country": "string",
                    "ContactPhoneNumbers": [
                        "string"
                    ],
                    "OfficePhoneNumbers": [
                        "string"
                    ],
                    "FaxNumbers": [
                        "string"
                    ],
                    "ContactEmailAddresses": [
                        "string"
                    ],
                    "OfficeEmailAddresses": [
                        "string"
                    ],
                    "IsContactInfoEmpty": true,
                    "IsContactPhoneNumberEmpty": true,
                    "IsOfficePhoneNumberEmpty": true,
                    "IsContactEmailAddressEmpty": true,
                    "IsOfficeEmailAddressEmpty": true,
                    "Name": "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",
                            "PictureFormatDescription": "string"
                        }
                    ],
                    "Employments": [
                        {
                            "IsInCompleteAddress": true,
                            "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
                        }
                    ],
                    "GenderDescription": "string",
                    "MaritalStatusDescription": "string",
                    "EducationLevelDescription": "string",
                    "EmploymentStatusDescription": "string",
                    "AccommodationStatusDescription": "string",
                    "CountryOfNationalityDescription": "string"
                }
            ],
            "BusinessAccountOwners": [
                {
                    "IsInCompleteAddress": true,
                    "StreetAddress1": "string",
                    "StreetAddress2": "string",
                    "City": "string",
                    "StateProvince": "string",
                    "ZipPostalCode": "string",
                    "LGA": "string",
                    "Country": "string",
                    "ContactPhoneNumbers": [
                        "string"
                    ],
                    "OfficePhoneNumbers": [
                        "string"
                    ],
                    "FaxNumbers": [
                        "string"
                    ],
                    "ContactEmailAddresses": [
                        "string"
                    ],
                    "OfficeEmailAddresses": [
                        "string"
                    ],
                    "IsContactInfoEmpty": true,
                    "IsContactPhoneNumberEmpty": true,
                    "IsOfficePhoneNumberEmpty": true,
                    "IsContactEmailAddressEmpty": true,
                    "IsOfficeEmailAddressEmpty": true,
                    "CustomerNumber": "string",
                    "Name": "string",
                    "RCNumber": "string",
                    "TaxID": "string",
                    "DateOfIncorporation": "2019-08-24T14:15:22Z",
                    "AnnualRevenue": 0,
                    "AssetValue": 0,
                    "Website": "string",
                    "TypeOfBusiness": "CommercialBank",
                    "CorporateOfficers": [
                        {
                            "IsInCompleteAddress": true,
                            "StreetAddress1": "string",
                            "StreetAddress2": "string",
                            "City": "string",
                            "StateProvince": "string",
                            "ZipPostalCode": "string",
                            "LGA": "string",
                            "Country": "string",
                            "ContactPhoneNumbers": [
                                "string"
                            ],
                            "OfficePhoneNumbers": [
                                "string"
                            ],
                            "FaxNumbers": [
                                "string"
                            ],
                            "ContactEmailAddresses": [
                                "string"
                            ],
                            "OfficeEmailAddresses": [
                                "string"
                            ],
                            "IsContactInfoEmpty": true,
                            "IsContactPhoneNumberEmpty": true,
                            "IsOfficePhoneNumberEmpty": true,
                            "IsContactEmailAddressEmpty": true,
                            "IsOfficeEmailAddressEmpty": true,
                            "Name": "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",
                                    "PictureFormatDescription": "string"
                                }
                            ],
                            "Employments": [
                                {
                                    "IsInCompleteAddress": true,
                                    "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",
                            "GenderDescription": "string",
                            "MaritalStatusDescription": "string",
                            "CorporateOfficerTypeDescription": "string",
                            "EducationLevelDescription": "string",
                            "EmploymentStatusDescription": "string",
                            "AccommodationStatusDescription": "string",
                            "CountryOfNationalityDescription": "string"
                        }
                    ],
                    "TypeOfBusinessDescription": "string"
                }
            ],
            "BusinessGuarantors": [
                {
                    "IsInCompleteAddress": true,
                    "StreetAddress1": "string",
                    "StreetAddress2": "string",
                    "City": "string",
                    "StateProvince": "string",
                    "ZipPostalCode": "string",
                    "LGA": "string",
                    "Country": "string",
                    "ContactPhoneNumbers": [
                        "string"
                    ],
                    "OfficePhoneNumbers": [
                        "string"
                    ],
                    "FaxNumbers": [
                        "string"
                    ],
                    "ContactEmailAddresses": [
                        "string"
                    ],
                    "OfficeEmailAddresses": [
                        "string"
                    ],
                    "IsContactInfoEmpty": true,
                    "IsContactPhoneNumberEmpty": true,
                    "IsOfficePhoneNumberEmpty": true,
                    "IsContactEmailAddressEmpty": true,
                    "IsOfficeEmailAddressEmpty": true,
                    "CustomerNumber": "string",
                    "Name": "string",
                    "RCNumber": "string",
                    "TaxID": "string",
                    "DateOfIncorporation": "2019-08-24T14:15:22Z",
                    "AnnualRevenue": 0,
                    "AssetValue": 0,
                    "Website": "string",
                    "TypeOfBusiness": "CommercialBank",
                    "CorporateOfficers": [
                        {
                            "IsInCompleteAddress": true,
                            "StreetAddress1": "string",
                            "StreetAddress2": "string",
                            "City": "string",
                            "StateProvince": "string",
                            "ZipPostalCode": "string",
                            "LGA": "string",
                            "Country": "string",
                            "ContactPhoneNumbers": [
                                "string"
                            ],
                            "OfficePhoneNumbers": [
                                "string"
                            ],
                            "FaxNumbers": [
                                "string"
                            ],
                            "ContactEmailAddresses": [
                                "string"
                            ],
                            "OfficeEmailAddresses": [
                                "string"
                            ],
                            "IsContactInfoEmpty": true,
                            "IsContactPhoneNumberEmpty": true,
                            "IsOfficePhoneNumberEmpty": true,
                            "IsContactEmailAddressEmpty": true,
                            "IsOfficeEmailAddressEmpty": true,
                            "Name": "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",
                                    "PictureFormatDescription": "string"
                                }
                            ],
                            "Employments": [
                                {
                                    "IsInCompleteAddress": true,
                                    "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",
                            "GenderDescription": "string",
                            "MaritalStatusDescription": "string",
                            "CorporateOfficerTypeDescription": "string",
                            "EducationLevelDescription": "string",
                            "EmploymentStatusDescription": "string",
                            "AccommodationStatusDescription": "string",
                            "CountryOfNationalityDescription": "string"
                        }
                    ],
                    "TypeOfBusinessDescription": "string"
                }
            ],
            "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",
                    "AccountStatusDescription": "string",
                    "LegalStatusDescription": "string"
                }
            ],
            "Collaterals": [
                {
                    "Collateral": "string",
                    "CollateralType": "None",
                    "CollateralValue": 0,
                    "CollateralCurrency": "A00",
                    "CollateralDate": "2019-08-24T14:15:22Z",
                    "CollateralTypeDescription": "string",
                    "CollateralCurrencyDescription": "string"
                }
            ],
            "AccountHistoryID": "string",
            "SubscriberID": "string",
            "AccountStatusDescription": "string",
            "LegalStatusDescription": "string",
            "AccountTypeDescription": "string",
            "InterestTypeDescription": "string",
            "CurrencyTypeDescription": "string",
            "RepaymentFrequencyDescription": "string"
        }
    }
    Built with