Registrations

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

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:

Example

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.

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:

Example

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:

Example

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 }
                }
              }
            }
          }
        }
      }
    }
  }
}