Getting Started With Signiant Verify API

Signiant Verify provides a verification and distribution workflow for assets, allowing Signiant SaaS platform users to easily submit assets for review and distribution to a streaming service, OTT provider, or other recipient with specific media requirements.

Users can submit assets for verification when they receive a request for one or more work orders from a Signiant Verify IT Administrator. Work orders are based on a delivery specification, defined by technical specifications created using the Signiant Verify API.

Technical specifications and delivery specifications are defined using the Signiant Verify API. Once a delivery specification is defined, it can be used in the Signiant Console to request content.

To use the Signiant Verify API, you must have a client_id and client_secret assigned to a MEDIA_FACTORY_IT_ADMIN role.

For more information about user roles, see User Roles on the Signiant Platform.

To get a set of API credentials, contact Signiant Customer Care.

Creating a Technical Specification

A technical specification defines an asset type that can be added to a delivery specification and used for validation by the Signiant Platform.

The validationSpec defines the aspects of the spec within the properties object using the JSON Schema standard format.

For example, the metadata properties used to validate an image in JPEG, JPG, or PNG for range of sizes would include properties to limit file formats and size.

...
"properties": {
          "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
          "format": {
            "enum": [
              "JPEG",
              "JPG",
              "PNG"
            ]
          },
          "frameSampleSize": {
            "enum": [
              "217x248",
              "1920x1080",
              "3840x2160"
            ]
          }
...

For more examples of different media types, see the Verify API Documentation.

Creating a Delivery Specification

After creating a technical specification, IT Administrators can create a delivery specification. The delivery specification allows IT Administrators to request work order deliveries using the Signiant Console or API. Delivery specifications include the storage profile and account used for the delivery, the technical specification requirements, and additional properties.

Creating a delivery specification allows you to set attributes that are common across many media types and work orders, including material details specific to its technical specifications.

Work Order Attributes

The materialDetails attribute accepts the following asset type values:

• Video
• Audio
• Metadata
• Artwork
• Image
• CC

Note: You must include least one valid technical specification and destination to send a content request to a user.

Delivery Specification Example

{
  "profileName": "Image Delivery Example",
  "specSummary": "Example delivery specification accepting images",
  "accountId": "c3c7ce48-1234-5678-8884-634ea45bd12c",
  "private": false,
  "deliveryReceipt": "None",
  "deliverySpecOwner": "Example Owner",
  "sendPartialDelivery": true,
  "materialDetails": [
    {
      "category": "Image", //
      "important": "Required",
      "deliveryTarget": "SigniantStorageSDCX"
    }
  ],
  "techSpecs": [
    {
      "techSpecName": "Example Technical Specification",
      "id": "SGNT1234567875522"
    }
  ]
}

Note: The techSpecs attribute accepts both the techSpecName or the id associated with the technical specification.

Creating a Work Order

A work order is a specific combination of technical and delivery specifications that uploads assets to the associated storage or OTT provider. Creating a work order via the Signiant API allows you to use a custom integration to fulfill a work order and deliver assets to storage.

Note: For information about sending and receiving assets from portal members using the Signiant Console, see the Signiant Help Center.

Note: You must have at least one valid delivery specification to create a work order.

Work Order Example

{
  "accountId": "c3c7ce48-1234-5678-8884-634ea45bd12c",
  "name": "Example Work Order",
  "deliverySpecId": "SGNT1713383653671",
  "deliverySpecName": "Image Delivery Example",
  "dueDate": "2026-07-16T15:00:00.000Z",
  "startDate": "2025-07-10T15:00:00.000Z",
  "createdOn": "2025-07-10T15:00:00.000Z",
  "materials": [
    {
      "path": {
        "type": "mediaShuttlePortal"
        "path": "/absolute/path/to/asset",
        "fileName": "image.jpg",
        "storageProfileName": ""
      },
      "type": "Image",
      "deliverySpecMaterialId": "Example Image",
      "sendPartialDelivery": true
    }
  ],
  "processes": {
    "collect": {
      "collectInventory": {
        "adapterId": "StubInventoryAdapter",
        "adapterName": "StubInventoryAdapter",
        "timeoutInSeconds": 400
      },
      "collectValidate": {
        "adapterId": "StubValidateAdapter",
        "adapterName": "StubValidateAdapter",
        "adapterData": {
          "username": "something"
        },
        "timeoutInSeconds": 600
      }
    },
    "assemble": {
      "assemblePackage": {
        "adapterId": "StubAssembleAdapter",
        "adapterName": "StubAssembleAdapter",
        "timeoutInSeconds": 600
      }
    },
    "distribute": {
      "distributeDelivery": {
        "adapterId": "StubDeliveryAdapter",
        "adapterName": "StubDeliveryAdapter",
        "timeoutInSeconds": 1000,
        "adapterData": {
          "additionalProp1": true
        }
      }
    }
  }
}