Prints

List your prints on a printer that a connector could claim.

Prints that are Printing and not yet linked to a connector's job, newest first. Match one to the job by fileHash (lowercase hex: the file's SHA-1 or a connector's file identity, so compare it only with hashes from the same source) or fileName, then claim it with POST /api/Prints/{id}/claim. hasSlicerSettings says whether the print already has its slicer settings recorded, so a connector can skip sending its own. Usage rows carry the slot each material was fed from, where known.

get/api/Prints/claimable

Request

  • Base URL: https://api.3dprintlog.com
  • URL: https://api.3dprintlog.com/api/Prints/claimable
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://3dprintlog.auth0.com/authorize, token URL https://3dprintlog.auth0.com/oauth/token)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Query parameters

printerIdinteger required

The printer the job is running on.

createdAfterstring date-time

Only prints created after this instant, e.g. a little before the job started.

limitinteger

The most prints to return, 1 to 100. Defaults to 20.

Response

The claimable prints. Empty when there are none, or the printer is not yours.

idinteger
titlestring nullable
printerIdinteger
status1 | 2 | 3 | 4 | 5 | 6

Sent as an integer: 1 = Pending, 2 = Printing, 3 = Success, 4 = Cancelled, 5 = Failed, 6 = PartialSuccess.

source0 | 1 | 2 | 3 | 4 | 5 | 6

How a print reached the API. Set on the server only, never taken from a request body. Rows created before the column existed stay PrintLogApi.Models.PrintSource.Unknown.

Sent as an integer: 0 = Unknown, 1 = Web, 2 = SlicerPlugin, 3 = OctoPrint, 4 = Moonraker, 5 = Mcp, 6 = ApiKey.

fileNamestring nullable
fileHashstring nullable

The file's identity as lowercase hex, when the creator or a claim sent one: the SHA-1 of the G-code, or a connector's own identity for the file (see PrintFileHashes).

createdDatestring date-time
startDatestring date-time nullable
hasSlicerSettingsboolean

Whether slicer settings are already recorded for the print (its slicer is known), so a connector can skip sending its own.

Changes

No recorded changes to this operation across all 1 revision of this API.