Socially is Nigeria and Africaβs #1 SMM Panel, delivering fast and affordable services for both resellers and end users. We offer a wide range of features, including social media boost services, airtime and data top-ups, SMS verification, and seamless crypto selling. Trusted across the continent, Socially combines speed, reliability, and value to help you grow and stay connected.
\nAn account must be registered to use the endpoints and resources provided here.
\nTo get a access token for your app, get in touch with Socially
\nNote: SMM uses a Key header, while SMS and PayBills use Bearer tokens in the Authorization header.
\nBy default, except stated otherwise, you must include the following header in each request:
\nAccept: application/json
\nContent-Type: application/json
\nThe API support standard HTTP methods as detailed below:
\nGET - For retrieve records
POST - For creating new records
Remember access tokens are long-lived that expire after 5 years.
\nNote: you can get your access token via API Settings [available for all users]
\nResponse codes can be any of the following:
\n200 - Ok
\n201 - Resource created
\n202 - Resource updated
\n400 - Bad Request
\n403 - Forbidden, possibly no or invalid access token
\n404 - Resource not found
\n405 - Bad method
\n422 - Validation error
\n429 - Too many requests
\n500 - Technical error
\n503 - Service unavailable
\nWhen server related errors (5**) persist, get in touch with our support team.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Overview","slug":"overview"}],"owner":"9698276","collectionId":"2dd471f5-614c-498c-9498-84f26a979641","publishedId":"2sAYQghoGC","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-01-27T12:46:20.000Z"},"item":[{"name":"Bills Payments","item":[{"name":"Cable Tv","item":[{"name":"Get Providers","id":"ed4c3c8c-b12c-4fb6-bc4d-2e567e7358ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request consist of available Cable Tv providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"path":["pay","bills","providers","cable-tv"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"4ad7de02-af4c-496a-8f72-3fa26ad384b3","name":"Get Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"{{baseUrl}}/pay/bills/providers/cable-tv"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"StarTimes\",\n \"min_amount\": \"50\",\n \"max_amount\": \"30000\",\n \"provider_code\": \"startimes\"\n },\n {\n \"provider_name\": \"GoTV\",\n \"min_amount\": \"50\",\n \"max_amount\": \"30000\",\n \"provider_code\": \"gotv\"\n }\n ]\n}"}],"_postman_id":"ed4c3c8c-b12c-4fb6-bc4d-2e567e7358ce"},{"name":"Get Packages","id":"f38ad32e-44ea-4c58-8a09-f88d3d5295e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request consist of available packages for Cable TV.
Please note the unique package code of each package, you will need it to
perform subsequent transactions
This request consist of available Data Bundle providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"path":["pay","bills","providers","data-bundle"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"fbb5122e-1bdb-4060-812c-7e49cbdee2f1","name":"Get Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"{{baseUrl}}/pay/bills/providers/data-bundle"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"MTN SME\",\n \"min_amount\": \"30\",\n \"max_amount\": \"20000\",\n \"provider_code\": \"mtn-sme\",\n \"provider_info\": \"Dial *323*4# to check your MTN data balance\"\n },\n {\n \"provider_name\": \"Glo (CG)\",\n \"min_amount\": \"30\",\n \"max_amount\": \"50000\",\n \"provider_code\": \"glo-cg\",\n \"provider_info\": \"Dial *323*# to check glo data balance\"\n }\n ]\n}"}],"_postman_id":"72dd1cd3-fd90-4c8a-8007-bbfcc7ffd35a"},{"name":"Get Packages","id":"f18a063c-da9c-4393-921a-23881a46ddb3","protocolProfileBehavior":{"disableBodyPruning":true,"followOriginalHttpMethod":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request consist of available packages for Data Bundle.
Please note the unique package code of each package, you will need it to
perform subsequent transactions
This request endpoint enables you to buy Data Bundle.
\nBelow are the request body parameters :
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\npackage_code -- Package code
\nreference -- (Merchant's Unique reference for the transaction.)
\n","urlObject":{"path":["pay","bills","buy","data-bundle"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"82d6da4f-0c7c-4012-9897-6e27c6a36c5e","name":"Buy Data Bundle","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{provider_code}}","type":"text","uuid":"30d63d53-9c0a-486c-8035-83afd68f5b9d"},{"key":"recipient","value":"{{recipient}}","type":"text","uuid":"a344908d-a34a-4192-b1d9-7fdda0ee88b7"},{"key":"package_code","value":"{{package_code}}","type":"text","uuid":"ab2e2850-1ce1-4b69-825f-6dea79822f27"},{"key":"reference","value":"{{reference}}","type":"text","uuid":"56cc4ac9-a508-4605-8c44-161756c0b8ec"}]},"url":"{{baseUrl}}/pay/bills/buy/data-bundle"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"reference\": \"{{reference}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"status\": \"{{status}}\"\n }\n}"}],"_postman_id":"57b38c0a-5750-46f4-b33e-b1c67c6f1a0e"}],"id":"3baa806f-c93d-41a9-8054-9d22901d9b70","_postman_id":"3baa806f-c93d-41a9-8054-9d22901d9b70","description":""},{"name":"Streaming TV","item":[{"name":"Get Providers","id":"dd54e04d-681b-4486-8236-80256f9e46b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request consist of available Streaming TV providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions
\n","urlObject":{"path":["pay","bills","providers","streaming-tv"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"d34e439b-3128-4014-83f0-cc1dc0e52ace","name":"Get Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/pay/bills/providers/streaming-tv"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"ShowMax\",\n \"min_amount\": \"1000\",\n \"max_amount\": \"30000\",\n \"provider_code\": \"showmax\"\n }\n ]\n}"}],"_postman_id":"dd54e04d-681b-4486-8236-80256f9e46b3"},{"name":"Get Packages","id":"a41a07d1-e21a-4345-a7bd-1db9e6804aae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This request consist of available packages for Streaming TV.
Please note the unique package code of each package, you will need it to
perform subsequent transactions
This request endpoints is for validation of recipients
\nBelow are the request body parameters :
\nprovider_code -- Provider Code
\nrecipient -- Recipient
\n","urlObject":{"path":["pay","bills","validation"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"e8bc9070-05e2-49b2-b75c-c0f2ae516580","name":"Validate Recipient","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{provider_code}}","type":"text","uuid":"26eea946-1700-4b65-a834-5b223e9dd003"},{"key":"recipient","value":"{{recipient}}","type":"text","uuid":"af4040f1-b287-4be3-991d-d0fea6331e93"}]},"url":"{{baseUrl}}/pay/bills/validation"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"verified\": true,\n \"message\": \"Verified MTN - {{recipient}} Number \"\n }\n}"}],"_postman_id":"475cbd87-8f79-428c-9519-3453637c6957"},{"name":"reQuery Transaction","id":"6521fb27-4e44-42a4-8c29-998df05a241f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint is used to requery a transaction.
\nBelow are the responses example :
\nreference -- (Merchant's Unique reference for the transaction.)
\nprovider -- Provider Name
\nrecipient -- The Recipient
\nstatus -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund, Failed
\namount_paid - The total amount paid for the transaction
\npackage -- Package name
\n","urlObject":{"path":["pay","bills","requery","{{reference}}","transaction"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"9fa953d8-bba6-4022-b076-406908edea2e","name":"reQuery Transaction","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"{{baseUrl}}/pay/bills/requery/{{reference}}/transaction"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"reference\": \"{{reference}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"status\": \"{{status}}\"\n }\n}"}],"_postman_id":"6521fb27-4e44-42a4-8c29-998df05a241f"}],"id":"f66a68d4-f7bc-4236-b28e-1a5bf04af0ab","_postman_id":"f66a68d4-f7bc-4236-b28e-1a5bf04af0ab","description":""},{"name":"SMS Verification","item":[{"name":"Get SMS Service Providers","id":"afc2a467-f8e2-4c22-bf60-cfc018a889de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"