{
  "swagger": "2.0",
  "info": {
    "title": "Persons API",
    "version": "1.0",
    "description": "This OAS2 (Swagger 2) API aims to present all endpoints for persons' handling.",
    "license": {
      "name": "Arkéa"
    },
    "contact": {
      "name": "Arkéa Pi Team",
      "email": "openbanking@arkea.com"
    }
  },
  "schemes": [
    "https"
  ],
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "securityDefinitions": {
    "OAuthToken": {
      "type": "apiKey",
      "name": "Authorization",
      "in": "header"
    }
  },
  "paths": {
    "/persons/{personId}": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "in": "path",
          "name": "personId",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "oneOf": [
                {
                  "type": "object",
                  "title": "Legal Person",
                  "description": "Description of a legal Person",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "Indicates if person is natural or not ",
                      "enum": [
                        "legal"
                      ]
                    },
                    "label": {
                      "oneOf": [
                        {
                          "description": "Original label"
                        }
                      ],
                      "title": "Label",
                      "description": "Description of a label",
                      "type": "string"
                    },
                    "birthName": {
                      "type": "string"
                    },
                    "birthDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "endDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "addresses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "documents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "phones": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "accounts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "representatives": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "createdById": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "updatedById": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id"
                  ]
                },
                {
                  "type": "object",
                  "title": "Physical Person",
                  "description": "Description of a physical Person",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "Indicates if person is natural or not ",
                      "enum": [
                        "natural"
                      ]
                    },
                    "label": {
                      "oneOf": [
                        {
                          "description": "Original label"
                        }
                      ],
                      "title": "Label",
                      "description": "Description of a label",
                      "type": "string"
                    },
                    "title": {
                      "type": "string",
                      "title": "Person Title (Enum)",
                      "description": "All potential titles for a person",
                      "enum": [
                        "MISTER",
                        "MISTRESS",
                        "MISS"
                      ]
                    },
                    "surname": {
                      "type": "string"
                    },
                    "firstName": {
                      "type": "string"
                    },
                    "birthName": {
                      "type": "string"
                    },
                    "birthDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "endDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "legalCapacity": {
                      "type": "string"
                    },
                    "addresses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "documents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mentees": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Person Mentee",
                        "description": "Description of a person mentee",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "$ref": "#/definitions/label"
                          },
                          "personId": {
                            "type": "string"
                          },
                          "relationship": {
                            "$ref": "#/definitions/personMenteeRelationship"
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "createdById": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "updatedById": {
                            "type": "string"
                          },
                          "validatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "validatedById": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "personId",
                          "role"
                        ]
                      }
                    },
                    "phones": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "createdById": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "updatedById": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "surname",
                    "firstName",
                    "birthDate"
                  ]
                }
              ],
              "title": "Person",
              "description": "Description of an Person (either physical, legal)"
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets designated person",
        "description": "Allows to get all data known on id desinated person"
      }
    },
    "/persons/{personId}/accounts": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "in": "path",
          "name": "personId",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "Description of a shorten account",
                "title": "Account shorten",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "label": {
                    "oneOf": [
                      {
                        "description": "Original label"
                      }
                    ],
                    "title": "Label",
                    "description": "Description of a label",
                    "type": "string"
                  },
                  "productId": {
                    "type": "string",
                    "enum": [
                      "business-account"
                    ]
                  },
                  "iban": {
                    "type": "string"
                  },
                  "participants": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "Description of an account participant",
                      "title": "Account participant",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "person": {
                          "$ref": "#/definitions/physicalPersonAsShort"
                        },
                        "role": {
                          "type": "string",
                          "title": "Account role (Enum)",
                          "description": "Description of all potential roles for an account",
                          "enum": [
                            "holder",
                            "co-holder",
                            "representative"
                          ]
                        }
                      },
                      "required": [
                        "id"
                      ]
                    }
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "createdById": {
                    "type": "string"
                  },
                  "updatedAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "updatedById": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets accounts from designated person",
        "description": "Allows to get all accounts known for designated person"
      }
    },
    "/persons/{personId}/addresses": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "in": "path",
          "name": "personId",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "type": "object",
                "title": "Address",
                "description": "Description of an address",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "number": {
                    "type": "string"
                  },
                  "routeId": {
                    "type": "string"
                  },
                  "streetName": {
                    "type": "string"
                  },
                  "additionalDetails": {
                    "type": "string"
                  },
                  "postBox": {
                    "type": "string"
                  },
                  "countryCode": {
                    "type": "string"
                  },
                  "validatedAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "validatedById": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "createdById": {
                    "type": "string"
                  },
                  "updatedAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "updatedById": {
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets addresses from designated person",
        "description": "Allows to get all addresses known for requested person"
      }
    },
    "/persons/{personId}/emails": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "name": "personId",
          "in": "path",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "type": "object",
                "title": "E-mail",
                "description": "Description of an e-mail",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "createdById": {
                    "type": "string"
                  },
                  "updatedAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "updatedById": {
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets mails from designated person",
        "description": "Allows to get all mails known for designated person"
      }
    },
    "/persons/{personId}/phoneNumbers": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "name": "personId",
          "in": "path",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "type": "object",
                "title": "Phone Number",
                "description": "Description of a phone number",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "createdById": {
                    "type": "string"
                  },
                  "updatedAt": {
                    "type": "string",
                    "format": "date-time",
                    "example": "2018-07-13T16:03:43.979"
                  },
                  "updatedById": {
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ]
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets phones from designated person",
        "description": "Allows to get all phone numbers known for designated person"
      }
    },
    "/persons/{personId}/representatives": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "in": "path",
          "name": "personId",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "type": "null"
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets representatives from designated person",
        "description": "Allows to get all representatives known for designated person"
      }
    },
    "/persons/{personId}/documents": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        },
        {
          "name": "personId",
          "in": "path",
          "type": "string",
          "required": true
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "http://stoplight-api.hml.s.arkea.com:8080/files.export?projectId=70&branch=version%2F1.0&path=models.oas2.yml#/definitions/digitalSafe"
              }
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets documents from designated person",
        "description": "Allows to get all documents known for designated person"
      }
    },
    "/persons/me": {
      "parameters": [
        {
          "$ref": "#/parameters/Authorization"
        },
        {
          "$ref": "#/parameters/Authentication"
        },
        {
          "$ref": "#/parameters/apikey"
        }
      ],
      "get": {
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "oneOf": [
                {
                  "type": "object",
                  "title": "Legal Person",
                  "description": "Description of a legal Person",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "Indicates if person is natural or not ",
                      "enum": [
                        "legal"
                      ]
                    },
                    "label": {
                      "oneOf": [
                        {
                          "description": "Original label"
                        }
                      ],
                      "title": "Label",
                      "description": "Description of a label",
                      "type": "string"
                    },
                    "birthName": {
                      "type": "string"
                    },
                    "birthDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "endDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "addresses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "documents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "phones": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "accounts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "representatives": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "createdById": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "updatedById": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id"
                  ]
                },
                {
                  "type": "object",
                  "title": "Physical Person",
                  "description": "Description of a physical Person",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string",
                      "description": "Indicates if person is natural or not ",
                      "enum": [
                        "natural"
                      ]
                    },
                    "label": {
                      "oneOf": [
                        {
                          "description": "Original label"
                        }
                      ],
                      "title": "Label",
                      "description": "Description of a label",
                      "type": "string"
                    },
                    "title": {
                      "type": "string",
                      "title": "Person Title (Enum)",
                      "description": "All potential titles for a person",
                      "enum": [
                        "MISTER",
                        "MISTRESS",
                        "MISS"
                      ]
                    },
                    "surname": {
                      "type": "string"
                    },
                    "firstName": {
                      "type": "string"
                    },
                    "birthName": {
                      "type": "string"
                    },
                    "birthDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "endDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "legalCapacity": {
                      "type": "string"
                    },
                    "addresses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "documents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "mentees": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Person Mentee",
                        "description": "Description of a person mentee",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "oneOf": [
                              {
                                "description": "Original label"
                              }
                            ],
                            "title": "Label",
                            "description": "Description of a label",
                            "type": "string"
                          },
                          "personId": {
                            "type": "string"
                          },
                          "relationship": {
                            "type": "string",
                            "title": "Person Mentee Relationship (Enum)",
                            "description": "All potential relationships for a mentee",
                            "enum": [
                              "child",
                              "company",
                              "guardianship"
                            ]
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "createdById": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "updatedById": {
                            "type": "string"
                          },
                          "validatedAt": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2018-07-13T16:03:43.979"
                          },
                          "validatedById": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "personId",
                          "role"
                        ]
                      }
                    },
                    "phones": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "title": "Identifier",
                        "description": "Description of an identifier",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "createdById": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2018-07-13T16:03:43.979"
                    },
                    "updatedById": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "surname",
                    "firstName",
                    "birthDate"
                  ]
                }
              ],
              "title": "Person",
              "description": "Description of an Person (either physical, legal)"
            }
          },
          "400": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          },
          "401": {
            "description": "Standard 401 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "401",
                "error": "Unauthorized"
              }
            }
          },
          "403": {
            "description": "Standard 403 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "403",
                "error": "Forbidden"
              }
            }
          },
          "404": {
            "description": "Standard 404 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "404",
                "error": "Not Found"
              }
            }
          },
          "429": {
            "description": "Standard 429 error response",
            "schema": {
              "type": "object",
              "title": "APIStandardError",
              "properties": {
                "status": {
                  "type": "string"
                },
                "error": {
                  "type": "string"
                }
              },
              "required": [
                "status",
                "error"
              ]
            },
            "examples": {
              "application/json": {
                "status": "429",
                "error": "Too Many Requests"
              }
            }
          },
          "500": {
            "description": "",
            "schema": {
              "type": "object",
              "title": "APIError",
              "description": "Standard APIError structure defined for 400 responses",
              "properties": {
                "errordate": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2018-07-13T16:03:43.979",
                  "description": "Error creation date"
                },
                "fishtag": {
                  "type": "string",
                  "example": "RandomTextIdentifier564",
                  "description": "Transaction uniq identifier"
                },
                "httpcode": {
                  "type": "integer",
                  "format": "int32",
                  "example": 500,
                  "description": "HTTP status code"
                },
                "messages": {
                  "type": "array",
                  "description": "Messages returned by API call",
                  "items": {
                    "type": "object",
                    "title": "APIMessage",
                    "description": "Standard APIMessage structure defined for all responses excepted the 2XX code response",
                    "properties": {
                      "code": {
                        "type": "string",
                        "example": "EX_FUNC_CODE_452",
                        "description": "Message functional code"
                      },
                      "level": {
                        "type": "string",
                        "example": "ERROR",
                        "description": "Message criticity level",
                        "enum": [
                          "INFO",
                          "WARNING",
                          "ERROR"
                        ]
                      },
                      "message": {
                        "type": "string",
                        "example": "An example error message",
                        "description": "Message text"
                      }
                    },
                    "required": [
                      "level",
                      "message"
                    ]
                  }
                },
                "url": {
                  "type": "string",
                  "example": "/called/url/25",
                  "description": "Called url"
                }
              },
              "required": [
                "httpcode",
                "url"
              ]
            }
          }
        },
        "summary": "Gets designated person",
        "description": "Allows to get all data known on connected person."
      }
    }
  },
  "parameters": {
    "Authorization": {
      "name": "Authorization",
      "in": "header",
      "type": "string"
    },
    "Authentication": {
      "name": "Authentication",
      "in": "header",
      "type": "string"
    },
    "apikey": {
      "name": "apikey",
      "in": "header",
      "type": "string"
    }
  },
  "basePath": "/person-api/v1/",
  "security": [
    {
      "OAuthToken": []
    }
  ]
}