Usage a smtp credential
/api/v1/smtp-credentials/{credential}/usageParameters
| Name | In | Type | Description |
|---|---|---|---|
credentialrequired | path | string | The credential identifier. |
Request
/api/v1/smtp-credentials/{credential}/usagecurl -X GET 'https://app.mailyte.com/api/v1/smtp-credentials/01JBT8XQ2M9WYC3K4F6R7S8T9V/usage' \
-H 'Authorization: Bearer mk_live_YOUR_API_KEY'const response = await fetch('https://app.mailyte.com/api/v1/smtp-credentials/01JBT8XQ2M9WYC3K4F6R7S8T9V/usage', {
method: 'GET',
headers: {
Authorization: 'Bearer mk_live_YOUR_API_KEY',
},
});
const { data } = await response.json();import requests
response = requests.get(
"https://app.mailyte.com/api/v1/smtp-credentials/01JBT8XQ2M9WYC3K4F6R7S8T9V/usage",
headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
)
data = response.json()["data"]<?php
$response = Http::withToken('mk_live_YOUR_API_KEY')
->get('https://app.mailyte.com/api/v1/smtp-credentials/01JBT8XQ2M9WYC3K4F6R7S8T9V/usage');
$data = $response->json('data');require "net/http"
require "json"
uri = URI("https://app.mailyte.com/api/v1/smtp-credentials/01JBT8XQ2M9WYC3K4F6R7S8T9V/usage")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer mk_live_YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }Response
Success.
dataobjectobjectstringsmtp_credential_usagewindowobjectThe period these counts cover, stated in full so you do not have to infer the end from the start.
daysintegerLength of the window in days.
sincestringWhen the counting window starts, in ISO 8601 UTC. Null when
countedis false.untilstringISO 8601 UTC. The moment the counts were computed against.
countedbooleanWhether the counts below were measured. False when the key is not set up on the mail server yet; the counts are then null, not 0.
totalintegerMessages sent with this key. Null means unknown, not 0.
deliveredintegerMessages accepted by the receiving server. Null means unknown, not 0.
bouncedintegerMessages permanently refused. Null means unknown, not 0.
deferredintegerMessages temporarily refused and retried. Null means unknown, not 0.
rejectedintegerMessages we refused before sending. Null means unknown, not 0.
last_used_atstringWhen the key last signed in to send, in ISO 8601 UTC, read live from the mail server. Null means it has never been used.
Returned inside the standard envelope.
Errors
| Status | When |
|---|---|
401 | The API key is missing, unknown, revoked or expired. All four answer identically, on purpose: distinguishing them would confirm which keys exist. |
403 | The key is valid but may not do this: it lacks the required scope, its IP allowlist does not include you, or this endpoint does not accept API keys. |
404 | No such resource in this organization. |
422 | The request was understood but the values were not acceptable. |
429 | Too many requests, or the organization has spent its sending allowance. `Retry-After` says how long to wait. |
Every status, with what causes it and what to do, is on the error reference.