TextKitDocs

List the filed copies of a registration

One entry per submission, oldest first: exactly what was sent for carrier review (business details, example messages, description, opt-in story) and how the checks stood.

GET/v1/registrations/{id}/submissions

Path Parameters

  • idstringrequired

    Example: reg_a1B2c3D4e5F6.

Details

Read-only. A copy is written when you submit and never changed; a resubmission adds a new one.

Responses

  • 200Page of RegistrationSubmission

    Filed copies, oldest first

  • 401Error

    Missing, malformed, or revoked API key

  • 402Error

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 404Error

    Not found

  • 429Error

    Rate limit or quota exceeded

Response Fields

The body is a page: data (the array), has_more, and next_cursor (null on the last page). Each item in data:

  • objectregistration_submission
  • registration_idstring

    Example: reg_a1B2c3D4e5F6.

  • numberinteger

    1 for the first submission, 2 for the first resubmission, and so on

  • submitted_atstring (date-time)
  • filed_bydelivered_compliance, registry
  • referencestring
  • sample_messagesarray of string
  • samples_sourcestarter, customer
  • descriptionstring
  • brandobject

    The business details as filed

  • campaignobject

    Use case, description, opt-in story, example messages and keyword replies as filed

  • website_checkobject

    Nullable.

  • website_check.checked_atstring (date-time)
  • website_check.passedinteger
  • website_check.failedinteger
  • website_check.warningsinteger
  • website_check.urlsobject
  • website_check.not_passingarray of string

    Ids of findings that were warnings (a failing finding blocks submission)

  • sample_checkobject
  • sample_check.passedinteger
  • sample_check.failedinteger
  • sample_check.warningsinteger
  • sample_check.not_passingarray of string
  • fee_acknowledgmentobject

    The registration fee terms accepted at this submit: the exact wording shown, when, and from which IP. Null on copies filed before the acknowledgment existed. Nullable.

  • fee_acknowledgment.statementstring
  • fee_acknowledgment.accepted_atstring (date-time)
  • fee_acknowledgment.ipstring

    Nullable.

Errors

Every error has the same JSON shape, and request_id matches the X-Request-Id response header. Errors lists every code and what to do about it.

  • 401

    Missing, malformed, or revoked API key

  • 402

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 404

    Not found

  • 429

    Rate limit or quota exceeded