-
API Reference
- AcceptOrder
- AcceptQuote
- ActivateModule
- AddAnnouncement
- AddBannedIp
- AddBillableItem
- AddCancelRequest
- AddClient
- AddClientNote
- AddContact
- AddCredit
- AddInvoicePayment
- AddOrder
- AddPayMethod
- AddProduct
- AddProjectMessage
- AddProjectTask
- AddTicketNote
- AddTicketReply
- AddTransaction
- AddUser
- AffiliateActivate
- ApplyCredit
- BlockTicketSender
- CancelOrder
- CapturePayment
- CloseClient
- CreateClientInvite
- CreateInvoice
- CreateOAuthCredential
- CreateOrUpdateTLD
- CreateProject
- CreateQuote
- CreateSsoToken
- DeactivateModule
- DecryptPassword
- DeleteAnnouncement
- DeleteClient
- DeleteContact
- DeleteOAuthCredential
- DeleteOrder
- DeletePayMethod
- DeleteProjectTask
- DeleteQuote
- DeleteTicket
- DeleteTicketNote
- DeleteTicketReply
- DeleteUserClient
- DomainGetLockingStatus
- DomainGetNameservers
- DomainGetWhoisInfo
- DomainRegister
- DomainRelease
- DomainRenew
- DomainRequestEPP
- DomainToggleIdProtect
- DomainTransfer
- DomainUpdateLockingStatus
- DomainUpdateNameservers
- DomainUpdateWhoisInfo
- DomainWhois
- EncryptPassword
- EndTaskTimer
- FraudOrder
- GenInvoices
- GetActivityLog
- GetAdminDetails
- GetAdminUsers
- GetAffiliates
- GetAnnouncements
- GetAutomationLog
- GetCancelledPackages
- GetClientGroups
- GetClientPassword
- GetClients
- GetClientsAddons
- GetClientsDetails
- GetClientsDomains
- GetClientsProducts
- GetConfigurationValue
- GetContacts
- GetCredits
- GetCurrencies
- GetEmailTemplates
- GetEmails
- GetHealthStatus
- GetInvoice
- GetInvoices
- GetModuleConfigurationParameters
- GetModuleQueue
- GetOrderStatuses
- GetOrders
- GetPayMethods
- GetPaymentMethods
- GetPermissionsList
- GetProducts
- GetProject
- GetProjects
- GetPromotions
- GetQuotes
- GetRegistrars
- GetServers
- GetStaffOnline
- GetStats
- GetSupportDepartments
- GetSupportStatuses
- GetTLDPricing
- GetTicket
- GetTicketAttachment
- GetTicketCounts
- GetTicketNotes
- GetTicketPredefinedCats
- GetTicketPredefinedReplies
- GetTickets
- GetToDoItemStatuses
- GetToDoItems
- GetTransactions
- GetUserPermissions
- GetUsers
- ListOAuthCredentials
- LogActivity
- MergeTicket
- ModuleChangePackage
- ModuleChangePw
- ModuleCreate
- ModuleCustom
- ModuleSuspend
- ModuleTerminate
- ModuleUnsuspend
- OpenTicket
- OrderFraudCheck
- PendingOrder
- ResetPassword
- SendAdminEmail
- SendEmail
- SendQuote
- SetConfigurationValue
- StartTaskTimer
- TriggerNotificationEvent
- UpdateAdminNotes
- UpdateAnnouncement
- UpdateClient
- UpdateClientAddon
- UpdateClientDomain
- UpdateClientProduct
- UpdateContact
- UpdateInvoice
- UpdateModuleConfiguration
- UpdateOAuthCredential
- UpdatePayMethod
- UpdateProject
- UpdateProjectTask
- UpdateQuote
- UpdateTicket
- UpdateTicketReply
- UpdateToDoItem
- UpdateTransaction
- UpdateUser
- UpdateUserPermissions
- UpgradeProduct
- ValidateLogin
- WhmcsDetails
GetOrderStatuses
Retrieve a list of order statuses and related counts
Request Parameters
Parameter | Type | Description | Required |
---|---|---|---|
action | string | “GetOrderStatuses” | Required |
Response Parameters
Parameter | Type | Description |
---|---|---|
result | string | The result of the operation: success or error |
totalresults | int | The total number of results available |
statuses | array | An array of order statuses |
Example Request (CURL)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
http_build_query(
array(
'action' => 'GetOrderStatuses',
// See https://developers.whmcs.com/api/authentication
'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
'password' => 'SECRET_OR_HASHED_PASSWORD',
'responsetype' => 'json',
)
)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);
Example Request (Local API)
$command = 'GetOrderStatuses';
$postData = array(
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later
$results = localAPI($command, $postData, $adminUsername);
print_r($results);
Example Response JSON
{
"result": "success",
"totalresults": 4,
"statuses": {
"status": [
{
"title": "Pending",
"count": 1
},
{
"title": "Active",
"count": 15
},
{
"title": "Fraud",
"count": 0
},
{
"title": "Cancelled",
"count": 1
}
]
}
}
Version History
Version | Changelog |
---|---|
1.0 | Initial Version |