Registrations

Registrations represent an order of registerables by an Account. Registerables can be Events, Learning Paths, Items and so on.

Search

The following example fetches the first page of Registrations for a specific Account and retrieves their list of Registerables, the order date and some other details:

Try Me

query Registrations {
  registrations(filters:[
    {field: account, operation: eq, value: "T3JnYW5pc2F0aW9uOjEz"}
  ]) {
    edges{
      node{
        id
        account{
          name
        }
        registerables{
          edges{
            node{
              id
              __typename
            }
          }
        }
        invoiceIssued
        orderDate
      }
    }
  }
}

For the full range of available filters see the RegistrationField API Reference.

Update

A Registration’s details, including its Order date, can be changed with the registration.update mutation. Setting orderDate is useful when importing historical registrations whose original order dates should be preserved:

Try Me

mutation UpdateOrderDate {
  registration{
    update(input: {
      registrationId: "UmVnaXN0cmF0aW9uOjE=",
      orderDate: "2022-11-15T09:00:00Z"
    }) {
      errors{ label message value }
    }
  }
}

For all updatable fields see the RegistrationUpdateInput API Reference.

Register learners

Learners can be added to an Event as

• named learners, when the identity of the person attending the training is known at the point of registration
• unnamed learners, to book and and invoice for a number of places on an Event without knowing the attendee’s identity in advance

The below examples cover the basics. For a full specification, see our RegisterLearnerInput API Reference.

Named learners

To create a new registration, follow the Event registration documentation

The following adds a registerable to an existing registration:

Try Me

mutation create_registration {
  registration{
    registerLearner(input:{
      contactId:"UGVyc29uOjI="
      eventId:"Q291cnNlOjE="
      registrationId:"UmVnaXN0cmF0aW9uOjU="
    }) {
      errors{
        label 
        message 
        value
      }
      registration{
        id
        registerables{
          edges{
            node{
              id
              __typename
              ... on Learner{
                contact{
                  personalName{ name }
                }
              }
            }
          }
        }
      }
    }
  }
}

Unnamed learners

The following adds 3 unnamed learners to an existing registration:

Try Me

mutation add_unnamed_learners {
  registration{
    registerUnnamedLearners(input:{
      eventId:"Q291cnNlOjE="
      registrationId:"UmVnaXN0cmF0aW9uOjU="
      quantity: 3
    }) {
      errors{
        label 
        message 
        value
      }
      registration{
        id
        registerables{
          edges{
            node{
              id
              __typename
              ... on Learner{
                contact{
                  personalName{ name }
                }
              }
            }
          }
        }
      }
    }
  }
}