Skip to content

Your cart is empty

Verifier

Enter serials to verify:

FAQ

API

MetalMark provides a REST API for working with our bills. Requests can be made with any language or library.

URL https://app.mtlmrk.com
Content type application/json
Rate limit ~120 requests per minute

Verify

This is an unauthenticated endpoint for returning information on any serial found on a MetalMark bill or Certificate of Authenticity (COA).

Endpoints

GET /api/verify
Returns information on serials
POST /api/verify
Returns information on serials

GET Returns information on serials

Parameters
sstringrequired

The serial to look up. This is typically the bill serial, but can also be the COA serial.

Required unless bill and coa are explicitly passed.

billstring

The serial number found on a bill.

Only used when coa is also explicitly passed.

coastring

The serial found on the COA.

Only used when bill is also explicitly passed.

Response
idstring

The identifier for the combination of series and edition.

descriptionstring

Longer form description.

dataobject

Contains information about the serial, like what series it is for, who made the artwork, how many were made, and more.

artiststring

The name of the primary artist whose work is depicted.

artNamestring

The title of the depicted artwork.

billPrefixstring

The prefix used to generate bill serials.

coaPrefixstring

The prefixed used to generate COA serials.

codestring

The code or SKU family for the series.

dateMintedstring

Alias for mintDate, an ISO8601 datestamp representing the date of creation.

descriptionstring

Longer form description.

editionstring

The identifier for the edition.

lotSizenumber

Alias for units, the total number made for this series and edition.

mintstring

The name of the mint or manufacturer.

mintDatestring

An ISO8601 datestamp representing the date of creation.

motdstring

A "mode of the day," usually a quick summary of the series.

seriesstring

The series or collection where this belongs.

unitsnumber

The total number made for this series and edition.

yearArtMadestring

The year the featured artwork was finished.

authenticityGuaranteestring

Returns the degree to which we can validate the serials.

When validating one serial (either bill or COA), this will be partial if we can find a match. When validating both a bill and COA serial together, this will be full if we find a match for both and they're part of the same set.

HTTP/2 200 OK { "id": "34", "description": "Artist Series - Frank Frazetta - 1000mg", "data": { "artist": "Frank Frazetta", "artName": "Dark Kingdom", "billPrefix": "MM", "coaPrefix": "", "code": "AS-FF-1K-AU", "dateMinted": "2024-05-15", "description": "Artist Series - Frank Frazetta - 1000mg", "edition": "First", "lotSize": 500, "mint": "MetalMark", "mintDate": "2024-05-15T15:34:49.124Z", "motd": "Dark Kingdom by Frank Frazetta, 1976", "series": "Artist Series", "units": 500, "yearArtMade": "1976", }, "authenticityGuarantee": "partial", }

POST Returns information on serials

Parameters
sstringrequired

The serial to look up. This is typically the bill serial, but can also be the COA serial.

Required unless bill and coa are explicitly passed.

billstring

The serial number found on a bill.

Only used when coa is also explicitly passed.

coastring

The serial found on the COA.

Only used when bill is also explicitly passed.

Response
idstring

The identifier for the combination of series and edition.

descriptionstring

Longer form description.

dataobject

Contains information about the serial, like what series it is for, who made the artwork, how many were made, and more.

artiststring

The name of the primary artist whose work is depicted.

artNamestring

The title of the depicted artwork.

billPrefixstring

The prefix used to generate bill serials.

coaPrefixstring

The prefixed used to generate COA serials.

codestring

The code or SKU family for the series.

dateMintedstring

Alias for mintDate, an ISO8601 datestamp representing the date of creation.

descriptionstring

Longer form description.

editionstring

The identifier for the edition.

lotSizenumber

Alias for units, the total number made for this series and edition.

mintstring

The name of the mint or manufacturer.

mintDatestring

An ISO8601 datestamp representing the date of creation.

motdstring

A "mode of the day," usually a quick summary of the series.

seriesstring

The series or collection where this belongs.

unitsnumber

The total number made for this series and edition.

yearArtMadestring

The year the featured artwork was finished.

authenticityGuaranteestring

Returns the degree to which we can validate the serials.

When validating one serial (either bill or COA), this will be partial if we can find a match. When validating both a bill and COA serial together, this will be full if we find a match for both and they're part of the same set.

HTTP/2 200 OK { "id": "34", "description": "Artist Series - Frank Frazetta - 1000mg", "data": { "artist": "Frank Frazetta", "artName": "Dark Kingdom", "billPrefix": "MM", "coaPrefix": "", "code": "AS-FF-1K-AU", "dateMinted": "2024-05-15", "description": "Artist Series - Frank Frazetta - 1000mg", "edition": "First", "lotSize": 500, "mint": "MetalMark", "mintDate": "2024-05-15T15:34:49.124Z", "motd": "Dark Kingdom by Frank Frazetta, 1976", "series": "Artist Series", "units": 500, "yearArtMade": "1976", }, "authenticityGuarantee": "partial", }