---
updatedAt: 2026-05-29T17:04:37.000Z
agentTools:
  projectIndex: https://docs-cpm.dataguard.com/llms.txt
---

# Stateless Submission endpoint

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "servers": [
    {
      "url": "api.consentric.io"
    }
  ],
  "info": {
    "version": "1.0",
    "title": "Permissions",
    "license": {
      "name": "(c) 2026 DataGuard. All Rights Reserved."
    }
  },
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "api_key",
        "in": "header"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "api_key": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/stateless-submission": {
      "post": {
        "operationId": "postStatelessSubmission",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "citizen": {
                    "properties": {
                      "externalRef": {
                        "description": "The unique reference associated with the Citizen.",
                        "example": "jb-mld-05",
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "citizenCapture": {
                    "properties": {
                      "applicationId": {
                        "description": "The ID associated with the target Application.",
                        "example": "d8BNrPqsgRZ",
                        "maxLength": 50,
                        "minLength": 1,
                        "type": "string"
                      },
                      "data": {
                        "additionalProperties": {},
                        "type": "object"
                      },
                      "partner": {
                        "maxLength": 100,
                        "minLength": 1,
                        "type": "string"
                      }
                    },
                    "required": [
                      "applicationId",
                      "partner"
                    ],
                    "type": "object"
                  },
                  "contactDetails": {
                    "properties": {
                      "applicationId": {
                        "description": "The ID associated with the target Application.",
                        "example": "d8BNrPqsgRZ",
                        "maxLength": 50,
                        "minLength": 1,
                        "type": "string"
                      },
                      "verification": {
                        "properties": {
                          "emailAddress": {
                            "description": "The Citizen's email address",
                            "example": "joe.bloggs@example.test",
                            "format": "email",
                            "minLength": 1,
                            "type": "string"
                          },
                          "locale": {
                            "description": "Locale of transaction.",
                            "example": "en-GB",
                            "maxLength": 20,
                            "minLength": 0,
                            "type": "string"
                          }
                        },
                        "required": [
                          "emailAddress"
                        ],
                        "type": "object"
                      }
                    },
                    "required": [
                      "applicationId"
                    ],
                    "type": "object"
                  },
                  "submissions": {
                    "items": {
                      "additionalProperties": {},
                      "type": "object"
                    },
                    "maxItems": 100,
                    "minItems": 0,
                    "type": "array"
                  },
                  "transactions": {
                    "items": {
                      "additionalProperties": {},
                      "type": "object"
                    },
                    "maxItems": 100,
                    "minItems": 0,
                    "type": "array"
                  }
                },
                "required": [
                  "contactDetails"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "externalRef": {
                      "description": "The unique reference associated with the Citizen.",
                      "example": "jb-mld-05",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Describes an error with the request",
                  "properties": {
                    "cause": {
                      "description": "The general cause of the error.",
                      "example": "Duplicated value detected.",
                      "type": "string"
                    },
                    "code": {
                      "description": "The code associated with the error.",
                      "example": "DuplicateValue",
                      "type": "string"
                    },
                    "detail": {
                      "description": "Further description of the error.",
                      "example": "The request contains a value which already exists within Consentric.",
                      "type": "string"
                    },
                    "fieldErrors": {
                      "description": "List of specific field errors for the request.",
                      "items": {
                        "description": "Describes an error relating to a specific field in the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "NotFound",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Option Id oB3Rps could not be found.",
                            "type": "string"
                          },
                          "field": {
                            "description": "The field that generated the error.",
                            "example": "request[0].changes[0].optionId",
                            "type": "string"
                          },
                          "rejectedValue": {
                            "description": "The value of the field that was rejected.",
                            "example": "oB3Rps"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "globalErrors": {
                      "description": "List of general errors for the request.",
                      "items": {
                        "description": "Describes a general error with the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "DuplicateValue",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Duplicate Data Ids: dts1.",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Bad Request"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Describes an error with the request",
                  "properties": {
                    "cause": {
                      "description": "The general cause of the error.",
                      "example": "Duplicated value detected.",
                      "type": "string"
                    },
                    "code": {
                      "description": "The code associated with the error.",
                      "example": "DuplicateValue",
                      "type": "string"
                    },
                    "detail": {
                      "description": "Further description of the error.",
                      "example": "The request contains a value which already exists within Consentric.",
                      "type": "string"
                    },
                    "fieldErrors": {
                      "description": "List of specific field errors for the request.",
                      "items": {
                        "description": "Describes an error relating to a specific field in the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "NotFound",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Option Id oB3Rps could not be found.",
                            "type": "string"
                          },
                          "field": {
                            "description": "The field that generated the error.",
                            "example": "request[0].changes[0].optionId",
                            "type": "string"
                          },
                          "rejectedValue": {
                            "description": "The value of the field that was rejected.",
                            "example": "oB3Rps"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "globalErrors": {
                      "description": "List of general errors for the request.",
                      "items": {
                        "description": "Describes a general error with the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "DuplicateValue",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Duplicate Data Ids: dts1.",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Forbidden"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Describes an error with the request",
                  "properties": {
                    "cause": {
                      "description": "The general cause of the error.",
                      "example": "Duplicated value detected.",
                      "type": "string"
                    },
                    "code": {
                      "description": "The code associated with the error.",
                      "example": "DuplicateValue",
                      "type": "string"
                    },
                    "detail": {
                      "description": "Further description of the error.",
                      "example": "The request contains a value which already exists within Consentric.",
                      "type": "string"
                    },
                    "fieldErrors": {
                      "description": "List of specific field errors for the request.",
                      "items": {
                        "description": "Describes an error relating to a specific field in the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "NotFound",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Option Id oB3Rps could not be found.",
                            "type": "string"
                          },
                          "field": {
                            "description": "The field that generated the error.",
                            "example": "request[0].changes[0].optionId",
                            "type": "string"
                          },
                          "rejectedValue": {
                            "description": "The value of the field that was rejected.",
                            "example": "oB3Rps"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "globalErrors": {
                      "description": "List of general errors for the request.",
                      "items": {
                        "description": "Describes a general error with the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "DuplicateValue",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Duplicate Data Ids: dts1.",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Conflict"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Describes an error with the request",
                  "properties": {
                    "cause": {
                      "description": "The general cause of the error.",
                      "example": "Duplicated value detected.",
                      "type": "string"
                    },
                    "code": {
                      "description": "The code associated with the error.",
                      "example": "DuplicateValue",
                      "type": "string"
                    },
                    "detail": {
                      "description": "Further description of the error.",
                      "example": "The request contains a value which already exists within Consentric.",
                      "type": "string"
                    },
                    "fieldErrors": {
                      "description": "List of specific field errors for the request.",
                      "items": {
                        "description": "Describes an error relating to a specific field in the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "NotFound",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Option Id oB3Rps could not be found.",
                            "type": "string"
                          },
                          "field": {
                            "description": "The field that generated the error.",
                            "example": "request[0].changes[0].optionId",
                            "type": "string"
                          },
                          "rejectedValue": {
                            "description": "The value of the field that was rejected.",
                            "example": "oB3Rps"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "globalErrors": {
                      "description": "List of general errors for the request.",
                      "items": {
                        "description": "Describes a general error with the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "DuplicateValue",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Duplicate Data Ids: dts1.",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Internal Server Error"
          },
          "501": {
            "content": {
              "application/json": {
                "schema": {
                  "description": "Describes an error with the request",
                  "properties": {
                    "cause": {
                      "description": "The general cause of the error.",
                      "example": "Duplicated value detected.",
                      "type": "string"
                    },
                    "code": {
                      "description": "The code associated with the error.",
                      "example": "DuplicateValue",
                      "type": "string"
                    },
                    "detail": {
                      "description": "Further description of the error.",
                      "example": "The request contains a value which already exists within Consentric.",
                      "type": "string"
                    },
                    "fieldErrors": {
                      "description": "List of specific field errors for the request.",
                      "items": {
                        "description": "Describes an error relating to a specific field in the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "NotFound",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Option Id oB3Rps could not be found.",
                            "type": "string"
                          },
                          "field": {
                            "description": "The field that generated the error.",
                            "example": "request[0].changes[0].optionId",
                            "type": "string"
                          },
                          "rejectedValue": {
                            "description": "The value of the field that was rejected.",
                            "example": "oB3Rps"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "globalErrors": {
                      "description": "List of general errors for the request.",
                      "items": {
                        "description": "Describes a general error with the request",
                        "properties": {
                          "errorCode": {
                            "description": "The code associated with the error.",
                            "example": "DuplicateValue",
                            "type": "string"
                          },
                          "errorDescription": {
                            "description": "The description for the corresponding errorCode",
                            "example": "Duplicate Data Ids: dts1.",
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Not Implemented"
          }
        },
        "summary": "Stateless Submission endpoint",
        "tags": [
          "Stateless Submissions"
        ]
      }
    }
  }
}
```