{"items":[{"type":"link","label":"SMS for Applications REST API","link":"/sms/sms4a-api","routeSlug":"/sms/sms4a-api","content":{"contentType":"overview","meta":{"name":"SMS for Applications REST API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"sms4a-api.json","url":"/_bundle/sms/sms4a-api.json?download"},{"kind":"download","label":"sms4a-api.yaml","url":"/_bundle/sms/sms4a-api.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://www.retarus.com/","url":"https://www.retarus.com/"},{"kind":"email","title":"Retarus","email":"info@retarus.com","label":"info@retarus.com","withCopyButton":true,"copyContent":"info@retarus.com"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.retarus.com/us/legal-disclaimer/"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"SMS for Applications REST API (v1.0.0)","showPageActions":true},{"nodeType":"markdoc","content":"Send SMS and look up delivery status via REST."},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"The Retarus SMS for Applications REST API is a service to send SMS and lookup the status.\n\nTo obtain a test account for this service or any of our other SMS services, please contact Retarus."}],"sectionId":"/sms/sms4a-api"}],"sectionId":"/sms/sms4a-api"}]}]}},{"type":"group","label":"SMS Jobs","link":"/sms/sms4a-api/sms-jobs","routeSlug":"/sms/sms4a-api/sms-jobs","items":[{"label":"Send SMS Job.","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sms/sms4a-api/sms-jobs/postjob","routeSlug":"/sms/sms4a-api/sms-jobs/postjob","metadata":{"seo":{"title":"Send SMS Job.","description":"Send one or more SMS with one or more recipients each. The total number of recipients is limited to 3000 per job. The response contains the job ID (jobId) of your new SMS job."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"postJob","name":"Send SMS Job.","isWebhook":false,"pointer":"/paths/~1jobs/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send SMS Job.","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Send one or more SMS with one or more recipients each. The total number of recipients is limited to 3000 per job. The response contains the job ID (jobId) of your new SMS job."},{"nodeType":"security","requirements":[{"schemes":[{"name":"httpBasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/JobRequest","exampleIds":["paths/~1jobs/post/requestBody/content/application~1json/examples/minimal","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS","paths/~1jobs/post/requestBody/content/application~1json/examples/complete"]}},"schemaId":"components/schemas/JobRequest","exampleIds":["paths/~1jobs/post/requestBody/content/application~1json/examples/minimal","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS","paths/~1jobs/post/requestBody/content/application~1json/examples/complete"],"pointer":"/paths/~1jobs/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/jobs","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"httpBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/JobRequest","exampleIds":["paths/~1jobs/post/requestBody/content/application~1json/examples/minimal","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS","paths/~1jobs/post/requestBody/content/application~1json/examples/complete"]}},"responseCodes":["201","400","401","409","422","429","default"],"pointer":"/jobs","href":"sms-jobs/postjob","openApiOperationId":"postJob","summary":"Send SMS Job."},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"schemaId":"components/schemas/JobRequest","exampleIds":["paths/~1jobs/post/requestBody/content/application~1json/examples/minimal","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS","paths/~1jobs/post/requestBody/content/application~1json/examples/complete"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/JobRequest","exampleIds":["paths/~1jobs/post/requestBody/content/application~1json/examples/minimal","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients","paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS","paths/~1jobs/post/requestBody/content/application~1json/examples/complete"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Job successfully created.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobResponse","exampleIds":["paths/~1jobs/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/JobResponse","exampleIds":["paths/~1jobs/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Invalid JobRequest-data (qos, encoding, ..).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/400/content/application~1json/example"]},{"code":"401","description":"Authentication failed."},{"code":"409","description":"Duplicate job (detected by enabled duplicate-detection).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1jobs/post/responses/409/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1jobs/post/responses/409/content/application~1json/example"]},{"code":"422","description":"Invalid JobRequest-data (invalid chars, no messages, ..).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/422/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/422/content/application~1json/example"]},{"code":"429","description":"Too many requests"},{"code":"default","description":"Other error response."}],"pointer":"/paths/~1jobs/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/JobResponse","exampleIds":["paths/~1jobs/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobResponse","exampleIds":["paths/~1jobs/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/400/content/application~1json/example"]}}},{"code":"401"},{"code":"409","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1jobs/post/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1jobs/post/responses/409/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/422/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponseWithDetails","exampleIds":["paths/~1jobs/post/responses/422/content/application~1json/example"]}}},{"code":"429"},{"code":"default"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sms-jobs/postjob"}],"panels":[]}]},"httpPath":"/jobs"},{"label":"Get all jobs for given criteria.","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sms/sms4a-api/sms-jobs/listjobs","routeSlug":"/sms/sms4a-api/sms-jobs/listjobs","metadata":{"seo":{"title":"Get all jobs for given criteria.","description":"Get a list of job IDs for a specified time period and corresponding to the other optional filters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listJobs","name":"Get all jobs for given criteria.","isWebhook":false,"pointer":"/paths/~1jobs/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get all jobs for given criteria.","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a list of job IDs for a specified time period and corresponding to the other optional filters."},{"nodeType":"security","requirements":[{"schemes":[{"name":"httpBasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"jobIdsOnly","in":"query","schemaId":"schema_149","description":"Return only jobIDs. Currently only 'true' is supported.","required":true},{"name":"fromTs","in":"query","schemaId":"schema_150","description":"From timestamp (ISO-8601). The interval between fromTs and toTs can be a maximum of 30 days."},{"name":"toTs","in":"query","schemaId":"schema_151","description":"To timestamp (ISO-8601). The interval between fromTs and toTs can be a maximum of 30 days."},{"name":"open","in":"query","schemaId":"schema_152","description":"Return only open jobs."},{"name":"offset","in":"query","schemaId":"schema_153","description":"Parameter used for pagination. Retrieve a subset of records starting with the offset value."},{"name":"limit","in":"query","schemaId":"schema_154","description":"Limit number of results returned. Value must be between 0 and 1000."}],"pointer":"/paths/~1jobs/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/jobs","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"parameters":{"path":[],"query":[{"name":"jobIdsOnly","in":"query","required":true,"schemaId":"schema_149"},{"name":"fromTs","in":"query","required":false,"schemaId":"schema_150"},{"name":"toTs","in":"query","required":false,"schemaId":"schema_151"},{"name":"open","in":"query","required":false,"schemaId":"schema_152"},{"name":"offset","in":"query","required":false,"schemaId":"schema_153"},{"name":"limit","in":"query","required":false,"schemaId":"schema_154"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"httpBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/jobs","href":"sms-jobs/listjobs","openApiOperationId":"listJobs","summary":"Get all jobs for given criteria."},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List jobs successful.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}},"schemaId":"schema_155"},{"code":"400","description":"Invalid request-parameter."},{"code":"401","description":"Authentication failed."},{"code":"500","description":"Can't list jobs."}],"pointer":"/paths/~1jobs/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_155","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}}},{"code":"400"},{"code":"401"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sms-jobs/listjobs"}],"panels":[]}]},"httpPath":"/jobs"},{"label":"Get job status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sms/sms4a-api/sms-jobs/getjob","routeSlug":"/sms/sms4a-api/sms-jobs/getjob","metadata":{"seo":{"title":"Get job status","description":"Get the job status and the list SMS IDs for the job.  In order to get the individual SMS status for all SMS's of a job, use the SMS status  endpoint /sms with the corresponding jobId parameter - eg /sms?jobId=J.20180620-085038.561-0jimrdkk7SOILYBNMK"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getJob","name":"Get job status","isWebhook":false,"pointer":"/paths/~1jobs~1{jobId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get job status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the job status and the list SMS IDs for the job.  In order to get the individual SMS status for all SMS's of a job, use the SMS status  endpoint /sms with the corresponding jobId parameter - eg /sms?jobId=J.20180620-085038.561-0jimrdkk7SOILYBNMK"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"httpBasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobId","in":"path","schemaId":"schema_156","description":"The Retarus job ID.","required":true}],"pointer":"/paths/~1jobs~1{jobId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/jobs/{jobId}","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"parameters":{"path":[{"name":"jobId","in":"path","required":true,"schemaId":"schema_156"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"httpBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/jobs/{jobId}","href":"sms-jobs/getjob","openApiOperationId":"getJob","summary":"Get job status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Get report for job ID successful.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobReport"}},"schemaId":"components/schemas/JobReport"},{"code":"400","description":"No jobID given."},{"code":"401","description":"Authentication failed."},{"code":"500","description":"Can't query report for jobId."}],"pointer":"/paths/~1jobs~1{jobId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/JobReport","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/JobReport"}}},{"code":"400"},{"code":"401"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sms-jobs/getjob"}],"panels":[]}]},"httpPath":"/jobs/{jobId}"}],"content":{"contentType":"group","meta":{"name":"SMS Jobs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"SMS Jobs","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/jobs","summary":"Send SMS Job.","prefix":{"name":"post","color":"post"},"badges":[],"link":"/sms-jobs/postjob","deprecated":false},{"title":"/jobs","summary":"Get all jobs for given criteria.","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sms-jobs/listjobs","deprecated":false},{"title":"/jobs/{jobId}","summary":"Get job status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sms-jobs/getjob","deprecated":false}]}]}]}]}},{"type":"group","label":"SMS Status","link":"/sms/sms4a-api/sms-status","routeSlug":"/sms/sms4a-api/sms-status","items":[{"label":"Get status for all recipients of a job.","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sms/sms4a-api/sms-status/listrecipients","routeSlug":"/sms/sms4a-api/sms-status/listrecipients","metadata":{"seo":{"title":"Get status for all recipients of a job.","description":"Get the individual SMS status for all SMS's of a job"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listRecipients","name":"Get status for all recipients of a job.","isWebhook":false,"pointer":"/paths/~1sms/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get status for all recipients of a job.","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get the individual SMS status for all SMS's of a job"},{"nodeType":"security","requirements":[{"schemes":[{"name":"httpBasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"jobId","in":"query","schemaId":"schema_156","description":"The Retarus job ID.","required":true}],"pointer":"/paths/~1sms/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sms","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"parameters":{"path":[],"query":[{"name":"jobId","in":"query","required":true,"schemaId":"schema_156"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"httpBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","404","500"],"pointer":"/sms","href":"sms-status/listrecipients","openApiOperationId":"listRecipients","summary":"Get status for all recipients of a job."},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Get report for all recipients of job ID successful.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_157"}},"schemaId":"schema_157"},{"code":"400","description":"No job ID given."},{"code":"401","description":"Authentication failed."},{"code":"404","description":"Invalid request"},{"code":"500","description":"Can't query report for jobID"}],"pointer":"/paths/~1sms/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_157","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_157"}}},{"code":"400"},{"code":"401"},{"code":"404"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/sms-status/listrecipients"}],"panels":[]}]},"httpPath":"/sms"}],"content":{"contentType":"group","meta":{"name":"SMS Status"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"SMS Status","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/sms","summary":"Get status for all recipients of a job.","prefix":{"name":"get","color":"get"},"badges":[],"link":"/sms-status/listrecipients","deprecated":false}]}]}]}]}},{"type":"group","label":"Version","link":"/sms/sms4a-api/version","routeSlug":"/sms/sms4a-api/version","items":[{"label":"Get version information","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/sms/sms4a-api/version/get","routeSlug":"/sms/sms4a-api/version/get","metadata":{"seo":{"title":"Get version information","description":"Get the version information for the API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get","name":"Get version information","isWebhook":false,"pointer":"/paths/~1version/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get version information","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get the version information for the API."},{"nodeType":"security","requirements":[{"schemes":[{"name":"httpBasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/version","servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"httpBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/version","href":"version/get","openApiOperationId":"get","summary":"Get version information"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/sms/sms4a-api","description":"Mock server","isMockServer":true},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Get version info successful.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VersionInfoResponse"}},"schemaId":"components/schemas/VersionInfoResponse"}],"pointer":"/paths/~1version/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/VersionInfoResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VersionInfoResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/version/get"}],"panels":[]}]},"httpPath":"/version"}],"content":{"contentType":"group","meta":{"name":"Version"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Version","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/version","summary":"Get version information","prefix":{"name":"get","color":"get"},"badges":[],"link":"/version/get","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/JobResponse":{"id":"components/schemas/JobResponse","kind":"json-schema","title":"JobResponse","data":{"type":"object","properties":{"jobId":{"type":"string","readOnly":true}}}},"components/schemas/JobRequest":{"id":"components/schemas/JobRequest","kind":"json-schema","title":"JobRequest","data":{"type":"object","required":["messages"],"properties":{"options":{"$ref":"#/components/schemas/Options"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message"}}}}},"components/schemas/Message":{"id":"components/schemas/Message","kind":"json-schema","title":"SMS messages","data":{"type":"object","title":"SMS messages","required":["recipients","text"],"properties":{"text":{"type":"string","description":"foo"},"recipients":{"type":"array","items":{"$ref":"#/components/schemas/Recipient"}}}}},"components/schemas/Options":{"id":"components/schemas/Options","kind":"json-schema","title":"Options","data":{"type":"object","properties":{"src":{"type":"string","examples":["retarus"],"pattern":"^(?:\\+?[0-9]{1,20}|[ -~]{1,11})$","description":"The Sender ID displayed to the recipient. Use a phone number, or a text ID of up to 11 printable ASCII characters. Not all carriers support punctuation and other special characters."},"encoding":{"type":"string","enum":["STANDARD","UTF-16"]},"billcode":{"type":"string","description":"Max. 70 characters."},"statusRequested":{"type":"boolean","description":"Delivery notification requested."},"flash":{"type":"boolean"},"customerRef":{"type":"string","description":"Recommended max. 64 characters."},"validityMin":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validity of the SMS in minutes. When 0 the provider’s default value is used. Otherwise, values must be between 5 and 2880 minutes."},"children":[]}]}]}]},"maxParts":{"type":"integer","format":"int32","description":"Maximum allowed parts in a multi-part message. Values must be between 1 and 20. Longer messages are truncated."},"invalidCharacters":{"type":"string","description":"Define how to handle invalid characters in SMS.","enum":["REFUSE","REPLACE","TO_UTF16","TRANSLITERATE"]},"qos":{"type":"string","description":"Quality of Service.","enum":["EXPRESS","NORMAL"]},"jobPeriod":{"type":"string","format":"date-time","examples":["2018-07-09T11:25:24.683+02:00"],"description":"Timestamp to schedule when to start processing the SMS Job (iso-8601)."},"duplicateDetection":{"type":"boolean"},"blackoutPeriods":{"type":"array","items":{"type":"string","examples":["2018-07-09T10:25:24.683+02:00/2018-07-09T11:25:24.683+02:00"],"description":"Time periods in which no SMS is delivered (iso-8601). SMS will be scheduled to be sent at the end of the blackout period."}}}}},"components/schemas/Recipient":{"id":"components/schemas/Recipient","kind":"json-schema","title":"Recipient","data":{"type":"object","required":["dst"],"properties":{"dst":{"type":"string"},"customerRef":{"type":"string","description":"Recommended max. 64 characters. Recipient mobile phone number used as default."},"blackoutPeriods":{"type":"array","items":{"type":"string","examples":["2018-07-09T10:25:24.683+02:00/2018-07-09T11:25:24.683+02:00"],"description":"Time periods in which no SMS is delivered (iso-8601). SMS will be scheduled to be sent at the end of the blackout period."}}}}},"components/schemas/JobReport":{"id":"components/schemas/JobReport","kind":"json-schema","title":"JobReport","data":{"type":"object","properties":{"jobId":{"type":"string","readOnly":true,"examples":["J.20220928-125820.020-0l8likuetGNOTM4A4U"]},"src":{"type":"string","description":"Sender ID.","readOnly":true,"examples":["retarus"]},"encoding":{"type":"string","readOnly":true,"enum":["standard","utf-16"]},"billcode":{"type":"string","readOnly":true,"examples":["Campaign123"]},"statusRequested":{"type":"boolean","description":"Delivery notification requested.","readOnly":true},"flash":{"type":"boolean","readOnly":true,"examples":[false]},"validityMin":{"type":"integer","format":"int64","description":"Validity of the SMS in minutes.","readOnly":true,"examples":[2880]},"customerRef":{"type":"string","description":"Recommended max. 64 characters.","readOnly":true,"examples":["InternalID: ABC1234 Tag: Marketing"]},"qos":{"type":"string","description":"Quality of Service.","readOnly":true,"enum":["EXPRESS","NORMAL"],"examples":["NORMAL"]},"receiptTs":{"type":"string","format":"date-time","examples":["2022-09-01T10:25:00.000Z"],"description":"Timestamp indicating when the job was received by Retarus (iso-8601).","readOnly":true},"finishedTs":{"type":"string","format":"date-time","examples":["2022-09-30T10:25:00.000Z"],"description":"Timestamp indicating when the SMS received its final status (iso-8601).","readOnly":true},"recipientIds":{"type":"array","readOnly":true,"items":{"type":"string"},"examples":[["S.20220928-125820.022-0l8likueyRB3CT8FTG"]]}}}},"components/schemas/RecipientReport":{"id":"components/schemas/RecipientReport","kind":"json-schema","title":"RecipientReport","data":{"type":"object","properties":{"smsId":{"type":"string","readOnly":true,"examples":["S.20220928-125820.022-0l8likueyRB3CT8FTG"]},"dst":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Recipient’s mobile phone number."},"children":[]}]}]}],"readOnly":true,"examples":["+4917600000000"]},"processStatus":{"type":"string","description":"Current process status (see SMS Outbound Status Codes).","readOnly":true,"examples":["DONE"]},"status":{"type":"string","description":"Status (see SMS Outbound Status Codes).","readOnly":true,"examples":["SUC_FIN"]},"customerRef":{"type":"string","description":"Recommended max. 64 characters.","readOnly":true,"examples":["TransactionID: ABC123"]},"reason":{"type":"string","readOnly":true,"examples":["message_state:DELIVERED [00000002] (Final) (Message is delivered to destination.)"]},"sentTs":{"type":"string","format":"date-time","examples":["2022-09-28T10:58:30.022Z"],"description":"Timestamp when the SMS was sent (iso-8601).","readOnly":true},"finishedTs":{"type":"string","format":"date-time","examples":["2022-09-28T10:59:34.150Z"],"description":"Timestamp which indicates when the SMS received its final status (iso-8601).","readOnly":true}}}},"components/schemas/VersionInfoResponse":{"id":"components/schemas/VersionInfoResponse","kind":"json-schema","title":"VersionInfoResponse","data":{"type":"object","properties":{"buildNumber":{"type":"integer","format":"int32","readOnly":true},"buildTimestamp":{"type":"string","readOnly":true},"majorVersion":{"type":"integer","format":"int32","readOnly":true},"minorVersion":{"type":"integer","format":"int32","readOnly":true},"versionInfo":{"type":"string","readOnly":true},"message":{"type":"string","readOnly":true}}}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}},"components/schemas/ErrorResponseWithDetails":{"id":"components/schemas/ErrorResponseWithDetails","kind":"json-schema","title":"ErrorResponseWithDetails","data":{"allOf":[{"$ref":"#/components/schemas/ErrorResponse"}],"properties":{"details":{"type":"string"}}}},"schema_149":{"kind":"json-schema","data":{"type":"boolean","default":true},"id":"schema_149"},"schema_150":{"kind":"json-schema","data":{"type":"string","format":"date-time","examples":["2022-06-13T00:00:00+02:00"]},"id":"schema_150"},"schema_151":{"kind":"json-schema","data":{"type":"string","format":"date-time","examples":["2022-06-20T00:00:00+02:00"]},"id":"schema_151"},"schema_152":{"kind":"json-schema","data":{"type":"boolean","default":false},"id":"schema_152"},"schema_153":{"kind":"json-schema","data":{"type":"integer","default":0,"minimum":0,"format":"int64"},"id":"schema_153"},"schema_154":{"kind":"json-schema","data":{"type":"integer","default":100,"maximum":1000,"minimum":1,"format":"int64"},"id":"schema_154"},"schema_155":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/JobReport"}},"id":"schema_155"},"schema_156":{"kind":"json-schema","data":{"type":"string","pattern":"J\\..{18,38}","examples":["J.20180620-085038.561-0jimrdkk7SOILYBNMK"]},"id":"schema_156"},"schema_157":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/RecipientReport"}},"id":"schema_157"}},"exampleStore":{"components/examples/SMSJobRequestMinimal":{"id":"components/examples/SMSJobRequestMinimal","value":{"messages":[{"text":"Your access code is ABC1234","recipients":[{"dst":"+4917600000000"}]}]},"summary":"Send one SMS message","description":"Send just one SMS - one message to one recipient - using default account options"},"components/examples/SMSJobRequestMultipleRecipients":{"id":"components/examples/SMSJobRequestMultipleRecipients","value":{"messages":[{"text":"Your summer vacation discount code is SUMMER22","recipients":[{"dst":"+4917100000000"},{"dst":"+4917200000000"},{"dst":"+4917600000000"}]}]},"summary":"Send one SMS message to multiple recipients","description":"Send one message to 3 recipients - equals 3 SMS - using default account options"},"components/examples/SMSJobRequestMultipleSMS":{"id":"components/examples/SMSJobRequestMultipleSMS","value":{"messages":[{"text":"Your OPT access code is code is ABC123","recipients":[{"dst":"+4917100000000"}]},{"text":"Your OPT access code is code is DEF456","recipients":[{"dst":"+4917200000000"}]},{"text":"Your OPT access code is code is GHI789","recipients":[{"dst":"+4917600000000"}]}]},"summary":"Send multiple SMS messages","description":"Send 3 different messages, each to 1 recipient - equals 3 SMS - using default account options"},"components/examples/SMSJobRequestComplete":{"id":"components/examples/SMSJobRequestComplete","value":{"options":{"src":"retarus","encoding":"STANDARD","billcode":"OTP","statusRequested":true,"flash":true,"customerRef":"TransactionID: ABC1234000","validityMin":10,"maxParts":3,"invalidCharacters":"REPLACE","qos":"EXPRESS","jobPeriod":"2023-04-26T15:30:00.000+02:00","duplicateDetection":true,"blackoutPeriods":["2022-07-09T20:00:00.000+02:00/2022-07-10T07:00:00.000+02:00"]},"messages":[{"text":"Your access code is ABC1234","recipients":[{"dst":"+4917600000000","customerRef":"TransactionID: ABC1234000 CustomerID: 123","blackoutPeriods":["2022-07-09T20:00:00.000+02:00/2022-07-10T07:00:00.000+02:00"]}]}]},"summary":"Send SMS with all options","description":"Send one SMS using all options"},"paths/~1jobs/post/requestBody/content/application~1json/examples/minimal":{"value":{"messages":[{"text":"Your access code is ABC1234","recipients":[{"dst":"+4917600000000"}]}]},"key":"minimal","summary":"Send one SMS message","description":"Send just one SMS - one message to one recipient - using default account options","id":"paths/~1jobs/post/requestBody/content/application~1json/examples/minimal"},"paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients":{"value":{"messages":[{"text":"Your summer vacation discount code is SUMMER22","recipients":[{"dst":"+4917100000000"},{"dst":"+4917200000000"},{"dst":"+4917600000000"}]}]},"key":"multipleRecipients","summary":"Send one SMS message to multiple recipients","description":"Send one message to 3 recipients - equals 3 SMS - using default account options","id":"paths/~1jobs/post/requestBody/content/application~1json/examples/multipleRecipients"},"paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS":{"value":{"messages":[{"text":"Your OPT access code is code is ABC123","recipients":[{"dst":"+4917100000000"}]},{"text":"Your OPT access code is code is DEF456","recipients":[{"dst":"+4917200000000"}]},{"text":"Your OPT access code is code is GHI789","recipients":[{"dst":"+4917600000000"}]}]},"key":"multipleSMS","summary":"Send multiple SMS messages","description":"Send 3 different messages, each to 1 recipient - equals 3 SMS - using default account options","id":"paths/~1jobs/post/requestBody/content/application~1json/examples/multipleSMS"},"paths/~1jobs/post/requestBody/content/application~1json/examples/complete":{"value":{"options":{"src":"retarus","encoding":"STANDARD","billcode":"OTP","statusRequested":true,"flash":true,"customerRef":"TransactionID: ABC1234000","validityMin":10,"maxParts":3,"invalidCharacters":"REPLACE","qos":"EXPRESS","jobPeriod":"2023-04-26T15:30:00.000+02:00","duplicateDetection":true,"blackoutPeriods":["2022-07-09T20:00:00.000+02:00/2022-07-10T07:00:00.000+02:00"]},"messages":[{"text":"Your access code is ABC1234","recipients":[{"dst":"+4917600000000","customerRef":"TransactionID: ABC1234000 CustomerID: 123","blackoutPeriods":["2022-07-09T20:00:00.000+02:00/2022-07-10T07:00:00.000+02:00"]}]}]},"key":"complete","summary":"Send SMS with all options","description":"Send one SMS using all options","id":"paths/~1jobs/post/requestBody/content/application~1json/examples/complete"},"paths/~1jobs/post/responses/201/content/application~1json/example":{"value":{"jobId":"J.20221116-102407.583-0lajfsfmoXIZJO93PQ"},"id":"paths/~1jobs/post/responses/201/content/application~1json/example"},"paths/~1jobs/post/responses/400/content/application~1json/example":{"value":{"code":400,"message":"Wrong qos: PRIORITY","details":"root.options.qos"},"id":"paths/~1jobs/post/responses/400/content/application~1json/example"},"paths/~1jobs/post/responses/409/content/application~1json/example":{"value":{"code":409,"message":"Duplicate job."},"id":"paths/~1jobs/post/responses/409/content/application~1json/example"},"paths/~1jobs/post/responses/422/content/application~1json/example":{"value":{"code":422,"message":"Invalid Characters in Message[001/001] 'ショートメッセージサービス' for encoding 'GSM7' and InvalidCharacters 'REFUSE'.","details":"root.messages[0]"},"id":"paths/~1jobs/post/responses/422/content/application~1json/example"}},"securitySchemeStore":{"httpBasicAuth":{"id":"httpBasicAuth","type":"http","scheme":"basic"}},"servers":[{"url":"/_mock/sms/sms4a-api","isMockServer":true,"description":"Mock server"},{"url":"https://sms4a.de2.retarus.com/rest/v1","description":"Primary data center"},{"url":"https://sms4a.de1.retarus.com/rest/v1","description":"Secondary data center"},{"url":"https://sms4a.eu.retarus.com/rest/v1","description":"HA endpoint - only to send SMS"}]},"options":{"layout":"stacked","hideSidebar":true,"mockServer":{"url":"/_mock/sms/sms4a-api","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/sms/sms4a-api.json?download"},{"url":"/_bundle/sms/sms4a-api.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"SMS for Applications REST API","description":"The Retarus SMS for Applications REST API is a service to send SMS and lookup the status.\n\nTo obtain a test account for this service or any of our other SMS services, please contact Retarus.","summary":"Send SMS and look up delivery status via REST."}},"baseSlug":"/sms/sms4a-api","routesMapping":{}}