Skip to content

License Signed

Emitted when an author (or an authorised signer on their behalf) signs a licence for a publication. Alongside the signing details — who signed, when, and which licence applies — the payload carries a shared manuscript-context block (publication and manuscript identity, journal, corresponding author, and any institutional agreement) so the event can be reconciled against a manuscript without a separate lookup.

Payload

json
{
  "publicationId": "PUB-2026-000123",
  "manuscriptId": "MS-2026-000123",
  "manuscriptTitle": "Advances in Example-Driven Research",
  "articleType": "Research Article",
  "doi": "10.1234/jes.2026.000123",
  "journalId": "JRN-001",
  "journalName": "Journal of Example Studies",
  "correspondingAuthorName": "Jane Doe",
  "authorCountry": "United Kingdom",
  "ringgoldName": "Example University",
  "ringgoldId": "12345",
  "dateSubmitted": "2026-01-15T08:00:00Z",
  "dateAccepted": "2026-03-10T11:20:00Z",
  "dateArticleWithdrawn": null,
  "institutionalAgreementName": "Example University Read & Publish",
  "institutionalAgreementType": "ReadAndPublish",
  "agreementDate": "2026-01-01T00:00:00Z",
  "dateSigned": "2026-04-20T09:30:00Z",
  "dateLicenseSelected": "2026-04-18T16:45:00Z",
  "signerUserId": "user-abc123",
  "isRetro": false,
  "licenseId": "LIC-042",
  "licenseName": "CC BY 4.0",
  "voucherRejectReason": ""
}

Fields

Manuscript context

FieldTypeDescription
publicationIdstringIdentifier of the publication the licence was signed for.
manuscriptIdstringPublisher-facing manuscript reference for the publication. Empty string when none is recorded.
manuscriptTitlestringTitle of the manuscript.
articleTypestringArticle type/category (for example, Research Article, Review). Empty string when not set.
doistringDOI of the publication. Empty string when not yet assigned (often the case at signing time).
journalIdstringIdentifier of the journal the publication belongs to.
journalNamestringDisplay name of the journal.
correspondingAuthorNamestringFull name of the corresponding author. Empty string when not available.
authorCountrystringCountry of the corresponding author's affiliation. Empty string when not available.
ringgoldNamestringInstitution name of the corresponding author's affiliation (Ringgold-registered organisation name). Empty string when not available.
ringgoldIdstringRinggold identifier of the corresponding author's affiliation. Empty string when not available.
dateSubmittedstring (ISO 8601 date-time, UTC) or nullTimestamp at which the manuscript was submitted. null when not recorded.
dateAcceptedstring (ISO 8601 date-time, UTC) or nullTimestamp at which the manuscript was accepted. null when not recorded.
dateArticleWithdrawnstring (ISO 8601 date-time, UTC) or nullTimestamp at which the article was withdrawn, if applicable. null for a normal signed licence.
institutionalAgreementNamestringName of the institutional agreement that applies to the publication (for example, Italy CARE-CRUI Agreement, Research 4 Life - AL, German Academic Consortium Discount). Empty string when no agreement applied.
institutionalAgreementTypestringCategory of the institutional agreement (for example, Voucher, Waiver, Discount). Empty string when no agreement applied.
agreementDatestring (ISO 8601 date-time, UTC) or nullStart date of the institutional agreement that applied. null when no agreement applied.

Licence signing

FieldTypeDescription
dateSignedstring (ISO 8601 date-time, UTC)Timestamp at which the licence was signed.
dateLicenseSelectedstring (ISO 8601 date-time, UTC) or nullTimestamp at which the publishing/licence option was selected (precedes signing). null when not recorded.
signerUserIdstringIdentifier of the user who signed the licence. This is the signer as recorded by ChronosHub — it may be the author or a delegated signer (for example, a co-author or institutional representative).
isRetrobooleantrue when the licence was signed retrospectively — that is, after the publication was already released under a prior agreement. false for a standard, forward-looking signature.
licenseIdstringIdentifier of the licence record in ChronosHub. Stable and suitable for use as a foreign key on the partner side.
licenseNamestringHuman-readable name or short code of the licence (for example, CC BY 4.0, CC BY-NC-ND 4.0).
voucherRejectReasonstringReason a voucher or agreement was rejected during option selection, when applicable. Empty string otherwise.

Notes

  • All timestamps are serialised as ISO 8601 strings.
  • The manuscript context block (identity, journal, corresponding author, and institutional agreement) is shared with the Invoice Paid event, so a partner can build or reconcile a manuscript record from either post-acceptance milestone.
  • Nullable date fields (dateSubmitted, dateAccepted, dateArticleWithdrawn, agreementDate, dateLicenseSelected) are emitted as null when no value is recorded. String fields default to an empty string rather than null.
  • The corresponding-author fields describe the first listed corresponding author and their primary affiliation.
  • This payload describes the event data only — not the transport-level envelope (event id, event type, signature headers, and so on).