GmSMS
GmSMS · REST API v1

Documentação da API

Integre números temporários e SMS na tua aplicação. Todos os endpoints devolvem JSON. Erros incluem o campo Error (string) quando aplicável.

Chave de API

Gera a chave no painel (uma ativa de cada vez). Usa no header Bearer.

URL base

Prefixa com o domínio público do site (o mesmo que usas no browser). Nos exemplos abaixo usamos o domínio atual só para copiares e testares aqui.

https://gmsms.com.br/api/v1

Exemplo: https://gmsms.com.br/api/v1/info

Autenticação

Inclui em todos os pedidos:

Header
Authorization: Bearer gmsms_live_…

Exemplo (substitui SEU_TOKEN_AQUI pela tua chave):

https://gmsms.com.br/api/v1/info

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/info' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Chaves começam por gmsms_live_. Nunca partilhes a chave em repositórios públicos.

Conta e catálogo

GET

Informações da conta

Nome, email, saldo formatado em BRL e data de criação da chave de API usada no pedido.

URL completa

https://gmsms.com.br/api/v1/info

GET/api/v1/info

Exemplo cURL

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/info' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Resposta de exemplo (JSON)

JSON
{
  "InfoBalance": {
    "AccountName": "",
    "AccountEmail": "",
    "AccountBalance": ""
  },
  "InfoToken": {
    "CreatedAt": ""
  }
}
GET

Listar países

Países disponíveis para pedidos, com ID numérico e nome.

URL completa

https://gmsms.com.br/api/v1/pais

GET/api/v1/pais

Exemplo cURL

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/pais' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Resposta de exemplo (JSON)

JSON
{
  "Paises": [
    { "ID": 0, "Name": "Russia" }
  ]
}
GET

Listar serviços

CountryId vai no path (não em query). Count só vem preenchido quando o ID do país é 73.

URL completa

https://gmsms.com.br/api/v1/servicos/73

GET/api/v1/servicos/73

Exemplo cURL

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/servicos/73' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Resposta de exemplo (JSON)

JSON
{
  "Services": [
    {
      "Code": "aaa",
      "Name": "Nubank",
      "Count": "9888"
    }
  ]
}

Pedidos

GET

Listar pedidos

Todos os pedidos da conta, mais recentes primeiro. O campo Status é o estado do pedido (ex.: waiting_sms, received, cancelled, error).

URL completa

https://gmsms.com.br/api/v1/pedidos

GET/api/v1/pedidos

Exemplo cURL

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/pedidos' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Resposta de exemplo (JSON)

JSON
{
  "Orders": [
    {
      "Id": "550e8400-e29b-41d4-a716-446655440000",
      "ActivationId": "635468024",
      "ServiceCode": "ig",
      "ServiceName": "Instagram",
      "CountryId": 73,
      "CountryName": "Brazil",
      "PhoneNumber": "5511999999999",
      "CountryPhoneCode": 55,
      "Status": "waiting_sms",
      "ChargedReais": 2.5,
      "LastSmsCode": null,
      "LastSmsText": null,
      "LastSmsAt": null,
      "ActivationTime": "2026-02-18T16:11:33+00:00",
      "ActivationEndTime": "2026-02-18T18:11:23+00:00",
      "ActivationOperator": "any",
      "CreatedAt": "2026-02-18T16:11:30+00:00",
      "UpdatedAt": "2026-02-18T16:11:30+00:00"
    }
  ]
}
GET

Consultar pedido

UUID do pedido no path. Só devolve se pertencer à conta da chave. Status igual ao do painel (aguardar SMS, recebido, etc.).

URL completa

https://gmsms.com.br/api/v1/pedidos/550e8400-e29b-41d4-a716-446655440000

GET/api/v1/pedidos/550e8400-e29b-41d4-a716-446655440000

Exemplo cURL

cURL
curl -sS -X GET 'https://gmsms.com.br/api/v1/pedidos/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI'

Resposta de exemplo (JSON)

JSON
{
  "Order": {
    "Id": "550e8400-e29b-41d4-a716-446655440000",
    "ActivationId": "635468024",
    "ServiceCode": "ig",
    "ServiceName": "Instagram",
    "CountryId": 73,
    "CountryName": "Brazil",
    "PhoneNumber": "5511999999999",
    "CountryPhoneCode": 55,
    "Status": "waiting_sms",
    "ChargedReais": 2.5,
    "LastSmsCode": null,
    "LastSmsText": null,
    "LastSmsAt": null,
    "ActivationTime": "2026-02-18T16:11:33+00:00",
    "ActivationEndTime": "2026-02-18T18:11:23+00:00",
    "ActivationOperator": "any",
    "CreatedAt": "2026-02-18T16:11:30+00:00",
    "UpdatedAt": "2026-02-18T16:11:30+00:00"
  }
}
POST

Solicitar número

Cria uma ativação no provedor, regista o pedido e debita o saldo da conta dona da chave.

URL completa

https://gmsms.com.br/api/v1/number

POST/api/v1/number

Exemplo cURL

cURL
curl -sS -X POST 'https://gmsms.com.br/api/v1/number' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{"ServiceId":"codigo_do_servico","CountryId":73}'

Corpo (JSON)

JSON
{
  "ServiceId": "codigo_do_servico",
  "CountryId": 73
}

Resposta de exemplo (JSON)

JSON
{
  "ActivationInfo": {
    "ActivationId": "635468024",
    "Phone": {
      "Number": "1332112323",
      "CountryPhoneCode": 62
    },
    "Cost": 12.8,
    "Status": { "Operator": "any" },
    "Time": {
      "CreatedAt": "2026-02-18T16:11:33+00:00",
      "ExpiresAt": "2026-02-18T18:11:23+00:00"
    }
  }
}