Query license usage

Request

Use this endpoint to check the status and usage of all your licensed services.

Query

idstring, (password)required

Required. The License Key issued by Melissa.

Example:id={REPLACE-WITH-YOUR-LICENSE-KEY}

tstring

Serves as a unique request identifier.

Example:t=Test

Acceptstringrequired

Format of the response.

Enum:"application/json""*/*"

Example:*/*

Content-Typestringrequired

Format of the request.

Value:"application/json"

Example:application/json

curl -i -X GET \
  'https://usage.melissadata.net/v1/license?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

Responses

Successful response

Bodyapplication/json

Versionstring

The current service version number.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global Email Result Codes.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

ResponseTimestampstring

The timestamp marking when the response was sent. In the format: YYYY-MM-DDTHH:MM:SS.SSSSSSSZ.

LastUpdatestring

The timestamp marking when the last update was made. In the format: 'YYYY-MM-DDTHH:MM:SS.SSSSSSS+ZZ:ZZ'.

ServiceCountinteger

Total number of records.

ServicesArray of objects

Response

{
  "Version": "10.0.1.1021",
  "TransmissionResults": "",
  "ResponseTimestamp": "2026-07-21T22:31:07.3170209Z",
  "LastUpdate": "2026-07-21T21:30:02.7303027+00:00",
  "ServiceCount": 17,
  "Services": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}