OpenAPI definition

You can find the definition online here: https://api2.openreview.net/docs/api.yml

Login to openreview

post

/login

Authorizations

Body

idstring · min: 1required

Any confirmed email address that is associated to the OpenReview Profile.

passwordstring · min: 1required

expiresIninteger · min: 1 | nullable

An optional parameter to determine the number of seconds before the assigned token expires.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/login' \
  --header 'Content-Type: application/json'

200

200

{
  "token": "text",
  "user": {
    "id": "text",
    "profile": {
      "id": "text",
      "first": "text",
      "middle": "text",
      "last": "text",
      "fullname": "text",
      "preferredEmail": "text",
      "preferredId": "text",
      "termsTimestamp": 1,
      "state": "Active",
      "emails": [
        "text"
      ],
      "usernames": [
        "text"
      ]
    }
  }
}

An object containing the assigned token and the OpenReview Profile.

Register a new user

post

/register

Authorizations

Body

emailstring · min: 1 · max: 254

Email that will be used to log in to OpenReview.

passwordstring

fullnamestring · min: 1

idstring

This is a Profile id. This parameter is only required when claiming an existing a Profile in OpenReview.

tokenstring | nullable

Token from Turnstile that proves that the user is human. This is required for registration.

nameobject

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/register' \
  --header 'Content-Type: application/json' \
  --data '{"name":{"first":"text"}}'

200

200

{
  "id": "text",
  "active": true,
  "password": true,
  "invitation": "text",
  "email": "text",
  "content": {
    "yearOfBirth": 1,
    "preferredEmail": "text",
    "gender": "text",
    "homepage": "text",
    "dblp": "text",
    "gscholar": "text",
    "wikipedia": "text",
    "linkedin": "text",
    "aclanthology": "text",
    "orcid": "text",
    "emails": [
      "text"
    ],
    "emailsConfirmed": [
      "text"
    ],
    "names": [
      {
        "preferred": true,
        "first": "text",
        "middle": "text",
        "last": "text",
        "fullname": "text",
        "username": "text"
      }
    ],
    "relations": [
      {
        "relation": "text",
        "name": "text",
        "email": "text",
        "username": "text",
        "readers": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "expertise": [
      {
        "keywords": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "history": [
      {
        "position": "text",
        "start": 1,
        "end": 1,
        "institution": {
          "name": "text",
          "domain": "text",
          "country": "text",
          "stateProvince": "text",
          "city": "text",
          "department": "text"
        }
      }
    ]
  },
  "metaContent": {},
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "termsTimestamp": 1,
  "state": "Active",
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ]
}

The Profile that is saved to the database.

Activate a user

put

/activate/{token}

Authorizations

Path parameters

tokenstringrequired

activation token

Body

contentobject

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/activate/{token}' \
  --header 'Content-Type: application/json'

200

200

{
  "token": "text",
  "user": {
    "id": "text",
    "active": true,
    "password": true,
    "invitation": "text",
    "email": "text",
    "content": {
      "yearOfBirth": 1,
      "preferredEmail": "text",
      "gender": "text",
      "homepage": "text",
      "dblp": "text",
      "gscholar": "text",
      "wikipedia": "text",
      "linkedin": "text",
      "aclanthology": "text",
      "orcid": "text",
      "emails": [
        "text"
      ],
      "emailsConfirmed": [
        "text"
      ],
      "names": [
        {
          "preferred": true,
          "first": "text",
          "middle": "text",
          "last": "text",
          "fullname": "text",
          "username": "text"
        }
      ],
      "relations": [
        {
          "relation": "text",
          "name": "text",
          "email": "text",
          "username": "text",
          "readers": [
            "text"
          ],
          "start": 1,
          "end": 1
        }
      ],
      "expertise": [
        {
          "keywords": [
            "text"
          ],
          "start": 1,
          "end": 1
        }
      ],
      "history": [
        {
          "position": "text",
          "start": 1,
          "end": 1,
          "institution": {
            "name": "text",
            "domain": "text",
            "country": "text",
            "stateProvince": "text",
            "city": "text",
            "department": "text"
          }
        }
      ]
    },
    "metaContent": {},
    "ddate": 1,
    "tcdate": 1,
    "tmdate": 1,
    "tauthor": "text",
    "termsTimestamp": 1,
    "state": "Active",
    "readers": [
      "text"
    ],
    "nonreaders": [
      "text"
    ],
    "writers": [
      "text"
    ],
    "signatures": [
      "text"
    ]
  }
}

user token

Moderate a user Profile

post

/profile/moderate

Authorizations

Body

idstringrequired

sendMailboolean | nullable

reasonstring | nullable

decisionstring · enumrequired

Options: accept, reject, block, unblock, delete, restore, limit

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/profile/moderate' \
  --header 'Content-Type: application/json' \
  --data '{"id":"text","decision":"accept"}'

200

400

403

200

{
  "id": "text",
  "active": true,
  "password": true,
  "invitation": "text",
  "email": "text",
  "content": {
    "yearOfBirth": 1,
    "preferredEmail": "text",
    "gender": "text",
    "homepage": "text",
    "dblp": "text",
    "gscholar": "text",
    "wikipedia": "text",
    "linkedin": "text",
    "aclanthology": "text",
    "orcid": "text",
    "emails": [
      "text"
    ],
    "emailsConfirmed": [
      "text"
    ],
    "names": [
      {
        "preferred": true,
        "first": "text",
        "middle": "text",
        "last": "text",
        "fullname": "text",
        "username": "text"
      }
    ],
    "relations": [
      {
        "relation": "text",
        "name": "text",
        "email": "text",
        "username": "text",
        "readers": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "expertise": [
      {
        "keywords": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "history": [
      {
        "position": "text",
        "start": 1,
        "end": 1,
        "institution": {
          "name": "text",
          "domain": "text",
          "country": "text",
          "stateProvince": "text",
          "city": "text",
          "department": "text"
        }
      }
    ]
  },
  "metaContent": {},
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "termsTimestamp": 1,
  "state": "Active",
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ]
}

user token

Activate a user

put

/activatelink/{token}

Authorizations

Path parameters

tokenstringrequired

Token used to activate new email

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/activatelink/{token}'

200

200

{
  "confirmedEmail": "text"
}

Confirmed email

Check if a user is activatable

get

/activatable/{token}

Authorizations

Path parameters

tokenstringrequired

activation token

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/activatable/{token}'

200

200

{
  "profile": {
    "id": "text",
    "active": true,
    "password": true,
    "invitation": "text",
    "email": "text",
    "content": {
      "yearOfBirth": 1,
      "preferredEmail": "text",
      "gender": "text",
      "homepage": "text",
      "dblp": "text",
      "gscholar": "text",
      "wikipedia": "text",
      "linkedin": "text",
      "aclanthology": "text",
      "orcid": "text",
      "emails": [
        "text"
      ],
      "emailsConfirmed": [
        "text"
      ],
      "names": [
        {
          "preferred": true,
          "first": "text",
          "middle": "text",
          "last": "text",
          "fullname": "text",
          "username": "text"
        }
      ],
      "relations": [
        {
          "relation": "text",
          "name": "text",
          "email": "text",
          "username": "text",
          "readers": [
            "text"
          ],
          "start": 1,
          "end": 1
        }
      ],
      "expertise": [
        {
          "keywords": [
            "text"
          ],
          "start": 1,
          "end": 1
        }
      ],
      "history": [
        {
          "position": "text",
          "start": 1,
          "end": 1,
          "institution": {
            "name": "text",
            "domain": "text",
            "country": "text",
            "stateProvince": "text",
            "city": "text",
            "department": "text"
          }
        }
      ]
    },
    "metaContent": {},
    "ddate": 1,
    "tcdate": 1,
    "tmdate": 1,
    "tauthor": "text",
    "termsTimestamp": 1,
    "state": "Active",
    "readers": [
      "text"
    ],
    "nonreaders": [
      "text"
    ],
    "writers": [
      "text"
    ],
    "signatures": [
      "text"
    ]
  },
  "activatable": {},
  "prefixed_positions": [],
  "prefixed_relations": [],
  "institutions": []
}

user token

Check if a user is activatable

post

/activatable

Authorizations

Body

idstring · min: 1 · max: 254required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/activatable' \
  --header 'Content-Type: application/json'

200

200

{
  "id": "text"
}

user token

Reset a user password

put

/reset/{token}

Authorizations

Path parameters

tokenstringrequired

reset token

Body

passwordstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/reset/{token}' \
  --header 'Content-Type: application/json' \
  --data '{"password":"text"}'

200

200

{
  "token": "text",
  "user": {
    "id": "text",
    "profile": {
      "id": "text",
      "first": "text",
      "middle": "text",
      "last": "text",
      "fullname": "text",
      "preferredEmail": "text",
      "preferredId": "text",
      "termsTimestamp": 1,
      "state": "Active",
      "emails": [
        "text"
      ],
      "usernames": [
        "text"
      ]
    }
  }
}

User is logged in after the password is reset.

Logout a user

post

/logout

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/logout'

200

200

{}

Empty object

Check if a user is resettable

get

/resettable/{token}

Authorizations

Path parameters

tokenstringrequired

reset token

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/resettable/{token}'

200

200

{
  "id": "text",
  "parent": "text",
  "content": {
    "ANY_ADDITIONAL_PROPERTY": {
      "description": "text",
      "order": 1,
      "delete": true,
      "value": "text",
      "readers": {}
    }
  },
  "cdate": 1,
  "mdate": 1,
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "host": "text",
  "web": "text",
  "domain": "text",
  "anonids": true,
  "secret": "text",
  "invitations": [
    "text"
  ],
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatories": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "members": [
    "text"
  ],
  "deanonymizers": [
    "text"
  ],
  "impersonators": [
    "text"
  ],
  "details": {
    "writable": true
  }
}

user token

Refresh a user token

post

/refreshToken

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/refreshToken'

200

200

{
  "token": "text",
  "user": {
    "id": "text",
    "profile": {
      "id": "text",
      "first": "text",
      "middle": "text",
      "last": "text",
      "fullname": "text",
      "preferredEmail": "text",
      "preferredId": "text",
      "termsTimestamp": 1,
      "state": "Active",
      "emails": [
        "text"
      ],
      "usernames": [
        "text"
      ]
    }
  }
}

user token

Check if a user is resettable

post

/resettable

Authorizations

Body

idstring · min: 1 · max: 254required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/resettable' \
  --header 'Content-Type: application/json' \
  --data '{"id":"text"}'

200

200

{
  "id": "text",
  "parent": "text",
  "content": {
    "ANY_ADDITIONAL_PROPERTY": {
      "description": "text",
      "order": 1,
      "delete": true,
      "value": "text",
      "readers": {}
    }
  },
  "cdate": 1,
  "mdate": 1,
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "host": "text",
  "web": "text",
  "domain": "text",
  "anonids": true,
  "secret": "text",
  "invitations": [
    "text"
  ],
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatories": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "members": [
    "text"
  ],
  "deanonymizers": [
    "text"
  ],
  "impersonators": [
    "text"
  ],
  "details": {
    "writable": true
  }
}

Group

Impersonate a user

post

/impersonate

Authorizations

Body

groupIdstring · min: 1required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/impersonate' \
  --header 'Content-Type: application/json' \
  --data '{"groupId":"text"}'

200

200

{
  "token": "text",
  "user": {
    "id": "text",
    "profile": {
      "id": "text",
      "first": "text",
      "middle": "text",
      "last": "text",
      "fullname": "text",
      "preferredEmail": "text",
      "preferredId": "text",
      "termsTimestamp": 1,
      "state": "Active",
      "emails": [
        "text"
      ],
      "usernames": [
        "text"
      ]
    },
    "disallowDataModification": true,
    "impersonatables": [
      "text"
    ],
    "impersonator": {
      "id": "text",
      "isSuperUser": true,
      "isVenueid": true,
      "profile": {
        "id": "text",
        "first": "text",
        "middle": "text",
        "last": "text",
        "fullname": "text",
        "preferredEmail": "text",
        "preferredId": "text",
        "termsTimestamp": 1,
        "state": "Active",
        "emails": [
          "text"
        ],
        "usernames": [
          "text"
        ]
      },
      "impersonator": {
        "id": "text",
        "isSuperUser": true,
        "isVenueid": true,
        "profile": {
          "id": "text",
          "first": "text",
          "middle": "text",
          "last": "text",
          "fullname": "text",
          "preferredEmail": "text",
          "preferredId": "text",
          "termsTimestamp": 1,
          "state": "Active",
          "emails": [
            "text"
          ],
          "usernames": [
            "text"
          ]
        }
      }
    }
  }
}

User token of the impersonated user and details of the impersonation.

Gets the next available OpenReview username for the passed names.

get

/tildeusername

Authorizations

Query parameters

firststring

first name

middlestring

middle name

laststring

last name

fullnamestring · min: 1

full name

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/tildeusername'

200

200

{
  "username": "text"
}

Next available tilde username

Confirm a new email

post

/user/confirm

Authorizations

Body

usernamestring · min: 1required

alternatestring · min: 1 · max: 254required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/user/confirm' \
  --header 'Content-Type: application/json' \
  --data '{"username":"text","alternate":"text"}'

200

200

{
  "alternate": "text"
}

user email

Download an attachment

get

/attachment

Authorizations

Query parameters

idstring · min: 1

Note id that contains the attachment.

idsany of

Note ids that contain the attachments.

namestring · min: 1required

Attachment field name inside the content of the Note. This is usually pdf or supplementary_material.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/attachment?name=text'

200

200

No body

Attachment

Upload an attachment

put

/attachment

Authorizations

Body

filestring · binaryrequired

namestring · min: 1required

Attachment field name. This is usually pdf or supplementary_material.

invitationIdstring · min: 1required

The id of the Invitation that allows to upload the attachment.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/attachment' \
  --header 'Content-Type: multipart/form-data' \
  --data '{"file":"text","name":"text","invitationId":"text"}'

200

200

{
  "url": "text"
}

Path to the attachment.

Upload an attachment chunk

put

/attachment/chunk

Authorizations

Body

filestring · binaryrequired

namestring · min: 1required

Attachment field name. This is usually pdf or supplementary_material.

invitationIdstring · min: 1required

The id of the Invitation that allows to upload the attachment.

clientUploadIdstring · min: 1 · max: 25required

Unique id that identifies all the chunks to the same file.

chunkIndexintegerrequired

The index of the chunk.

totalChunksinteger · min: 1required

The total number of chunks.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/attachment/chunk' \
  --header 'Content-Type: multipart/form-data' \
  --data '{"file":"text","name":"text","invitationId":"text","clientUploadId":"text","chunkIndex":1,"totalChunks":1}'

200

200

{
  "url": "text"
}

Path to the attachment.

Download a PDF

get

/pdf

Authorizations

Query parameters

idstring · min: 1

Note id that contains the PDF.

idsany of

Note ids that contain the attachments.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/pdf'

200

200

No body

PDF

Get a PDF

get

/pdf/{id}

Authorizations

Path parameters

idstringrequired

PDF id. This is the value saved in the pdf field of the Note.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/pdf/{id}'

200

200

No body

pdf

Compare PDFs

get

/pdf/compare

Authorizations

Query parameters

noteIdstringrequired

Note id

leftIdstringrequired

Edit id

rightIdstringrequired

Edit id

fieldstring · default: pdf

field to compare

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/pdf/compare?noteId=text&leftId=text&rightId=text'

200

200

No body

pdf comparison

Get edges

get

/edges

Authorizations

Query parameters

idstring · min: 1

Edge id

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

sortstring · min: 1

Sort returned Edges by field.

invitationstring · min: 1

Invitation id used to create the Edge(s).

headstring · min: 1

head value of the Edge(s).

tailstring · min: 1

tail value of the Edge(s).

labelstring · min: 1

label of the Edge(s).

trashboolean

Whether to return deleted Edges as well.

groupBystring · min: 1

Group result by different Edge fields.

selectany of

Fields of the Edge to return in the result. Requires groupBy.

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are head, tail, writable and all.

Example: head,tail

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Edges belong to to filter transitive members.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/edges'

200

200

{
  "count": 1,
  "cache": true,
  "edges": [],
  "groupedEdges": [
    {
      "id": {},
      "count": 1,
      "values": [
        {}
      ]
    }
  ]
}

edges

Create an edge

post

/edges

Authorizations

Body

invitationstring · min: 1

headany ofrequired

tailany ofrequired

ddateany of

cdateany of

tcdateinteger · max: 9999999999999

tmdateinteger · max: 9999999999999

readersany of

nonreadersany of

writersany of

signaturesany of

tauthorstring · min: 1

domainstring · min: 1

idany of

labelany of

weightany of

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/edges' \
  --header 'Content-Type: application/json'

200

200

{
  "invitation": "text",
  "head": "text",
  "tail": "text",
  "ddate": 1,
  "cdate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "tauthor": "text",
  "domain": "text",
  "id": "text",
  "label": "text",
  "weight": 1
}

Edge

Rename an edge

post

/edges/rename

Authorizations

Body

currentIdstring · min: 1required

newIdstring · min: 1required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/edges/rename' \
  --header 'Content-Type: application/json' \
  --data '{"currentId":"text","newId":"text"}'

200

200

[]

edge

Get edges count

get

/edges/count

Authorizations

Query parameters

idstring · min: 1

Edge id

invitationstring · min: 1

Invitation id used to create the Edge(s).

headstring · min: 1

head value of the Edge(s).

tailstring · min: 1

tail value of the Edge(s).

labelstring · min: 1

label of the Edge(s).

trashboolean

Whether to return deleted Edges as well.

domainstring · min: 1

Domain the Edges belong to to filter transitive members.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/edges/count'

200

200

{
  "count": 1
}

edges

Get archived edges

get

/edges/archive

Authorizations

Query parameters

invitationstring · min: 1required

Invitation id used to create the Edge(s).

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/edges/archive?invitation=text'

200

200

No body

Archived edges

Send feedback to the OpenReview team

put

/feedback

Authorizations

Body

fromstring · min: 1required

Email address of the user sending the feedback.

subjectstring

Subject of the feedback.

messagestring · min: 1required

The feedback.

tokenstringrequired

Turnstile token.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/feedback' \
  --header 'Content-Type: application/json' \
  --data '{"from":"text","message":"text","token":"text"}'

200

200

{
  "status": "text"
}

feedback

Get user profiles

get

/profiles

Authorizations

Query parameters

idstring · min: 1

Profile id

Pattern: ^~.*\d+$

idsany of

Profile ids

emailstring · min: 1

Email associated with the Profile.

emailsany of

Email(s) associated with the Profile.

confirmedEmailstring · min: 1

Confirmed email associated with the Profile.

confirmedEmailsany of

Confirmed email(s) associated with the Profile.

firststring · min: 1

First name associated with the Profile.

middlestring | nullable

Middle name associated with the Profile.

laststring · min: 1

Last name associated with the Profile.

termstring · min: 1

Email, Fullname or part of the fullname associated with the Profile.

relationstring · min: 1

Relation associated to the Profile.

dblpstring · min: 1

dblp link associated to the Profile.

groupstring · min: 1

Group id where to get all the member profiles.

trashboolean

Whether to include deleted profiles.

withBlockedboolean

Whether to include blocked profiles.

needsModerationboolean

Whether to return Profiles that need moderation.

selectstring · min: 1

Comma separated string with specific fields of the Profile object to return.

Example: id,content.names,content.emails

statestring · enum

State of the Profile.

Options: Inactive, Needs Moderation, Active Institutional, Active Automatic, Active, Blocked, Limited, Merged, Rejected

sortstring · min: 1

Sort returned Profiles by field.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/profiles'

200

200

{
  "count": 1,
  "fromCache": true,
  "profiles": []
}

Profile response

Save user Profile

post

/profiles

Authorizations

Body

idstring · min: 1

invitationstring · min: 1

referentstring · min: 1

tcdateinteger

tmdateinteger

ddateinteger | nullable

packagingobject

activeboolean

passwordboolean

tauthorstring

statestring · enum

Options: Active, Active Institutional, Active Automatic, Inactive, Blocked, Rejected, Needs Moderation, Merged, Limited

readersstring · min: 1[]

nonreadersstring · min: 1[] | nullable

writersstring · min: 1[]

signaturesstring · min: 1[]required

contentobject

metaContentobject

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/profiles' \
  --header 'Content-Type: application/json'

200

200

{
  "id": "text",
  "active": true,
  "password": true,
  "invitation": "text",
  "email": "text",
  "content": {
    "yearOfBirth": 1,
    "preferredEmail": "text",
    "gender": "text",
    "homepage": "text",
    "dblp": "text",
    "gscholar": "text",
    "wikipedia": "text",
    "linkedin": "text",
    "aclanthology": "text",
    "orcid": "text",
    "emails": [
      "text"
    ],
    "emailsConfirmed": [
      "text"
    ],
    "names": [
      {
        "preferred": true,
        "first": "text",
        "middle": "text",
        "last": "text",
        "fullname": "text",
        "username": "text"
      }
    ],
    "relations": [
      {
        "relation": "text",
        "name": "text",
        "email": "text",
        "username": "text",
        "readers": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "expertise": [
      {
        "keywords": [
          "text"
        ],
        "start": 1,
        "end": 1
      }
    ],
    "history": [
      {
        "position": "text",
        "start": 1,
        "end": 1,
        "institution": {
          "name": "text",
          "domain": "text",
          "country": "text",
          "stateProvince": "text",
          "city": "text",
          "department": "text"
        }
      }
    ]
  },
  "metaContent": {},
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "termsTimestamp": 1,
  "state": "Active",
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ]
}

Profile response

Get user profiles

get

/profiles/search

Authorizations

Query parameters

idstring · min: 1

Profile id

Pattern: ^~.*\d+$

idsany of

Profile ids

emailstring · min: 1

Email associated with the Profile.

emailsany of

Email(s) associated with the Profile.

confirmedEmailstring · min: 1

Confirmed email associated with the Profile.

confirmedEmailsany of

Confirmed email(s) associated with the Profile.

firststring · min: 1

First name associated with the Profile.

middlestring | nullable

Middle name associated with the Profile.

laststring · min: 1

Last name associated with the Profile.

fullnamestring · min: 1

Fullname associated with the Profile.

esboolean

Whether to use ElasticSearch to search for profiles.

termstring · min: 1

Email, Fullname or part of the fullname associated with the Profile.

groupstring · min: 1

Group id where to get all the member profiles.

trashboolean

Whether to include deleted profiles.

withBlockedboolean

Whether to include blocked profiles.

needsModerationboolean

Whether to return Profiles that need moderation.

selectstring · min: 1

Comma separated string with specific fields of the Profile object to return.

Example: id,content.names,content.emails

statestring · enum

State of the Profile.

Options: Inactive, Needs Moderation, Active Institutional, Active Automatic, Active, Blocked, Limited, Merged, Rejected

sortstring · min: 1

Sort returned Profiles by field.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/profiles/search'

200

200

{
  "count": 1,
  "fromCache": true,
  "profiles": []
}

Profile response

Get user profiles

post

/profiles/search

Authorizations

Query parameters

idstring · min: 1

Profile id

Pattern: ^~.*\d+$

idsany of

Profile ids

emailstring · min: 1

Email associated with the Profile.

emailsany of

Email(s) associated with the Profile.

confirmedEmailstring · min: 1

Confirmed email associated with the Profile.

confirmedEmailsany of

Confirmed email(s) associated with the Profile.

firststring · min: 1

First name associated with the Profile.

middlestring | nullable

Middle name associated with the Profile.

laststring · min: 1

Last name associated with the Profile.

termstring · min: 1

Email, Fullname or part of the fullname associated with the Profile.

groupstring · min: 1

Group id where to get all the member profiles.

trashboolean

Whether to include deleted profiles.

withBlockedboolean

Whether to include blocked profiles.

needsModerationboolean

Whether to return Profiles that need moderation.

selectstring · min: 1

Comma separated string with specific fields of the Profile object to return.

Example: id,content.names,content.emails

statestring · enum

State of the Profile.

Options: Inactive, Needs Moderation, Active Institutional, Active Automatic, Active, Blocked, Limited, Merged, Rejected

sortstring · min: 1

Sort returned Profiles by field.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/profiles/search'

200

200

{
  "count": 1,
  "fromCache": true,
  "profiles": []
}

Profile response

Gets profile references

get

/references

Authorizations

Query parameters

idstring · min: 1

Group id.

idsany of

Group ids.

referentstring · min: 1

Profile id that the reference is modifying.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

sortstring · min: 1

Select field to sort by.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/references'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "references": []
}

The Profile that is saved to the database.

Returns groups

get

/groups

Authorizations

Query parameters

idstring · min: 1

Group id.

idsany of

Group ids.

prefixstring · min: 1

Group id prefix.

parentstring · min: 1

Group parent.

memberstring · min: 1

Group id to get its transitive members.

membersstring · min: 1

Group id to get groups that the Group is member of.

signaturestring · min: 1

Group id used to sign the returned Groups.

signatorystring · min: 1

Group id that can is allowed to sign with the returned Groups.

writerstring · min: 1

Group id that is writer of the returned Groups.

hoststring · min: 1 | nullable

Host of the returned Groups.

selectstring · min: 1

Comma separated string with specific fields of the Group object to return.

Example: id,members

detailsstring · min: 1

Comma separated values of fields to add to details. Valid value is writable.

Example: writable

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

sortstring · min: 1

Select field to sort by.

webboolean

Whether to return web ui code

streamboolean

Whether to use a stream to process results or not.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Groups belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/groups'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "groups": []
}

Group response

Adds members to a Group

put

/groups/members

Authorizations

Body

idstring · min: 1required

Group id to which memebers will be added.

membersstring · min: 1[]required

Members to add to the Group.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api2.openreview.net/groups/members' \
  --header 'Content-Type: application/json' \
  --data '{"id":"text","members":[null]}'

200

default

200

{
  "id": "text",
  "parent": "text",
  "content": {
    "ANY_ADDITIONAL_PROPERTY": {
      "description": "text",
      "order": 1,
      "delete": true,
      "value": "text",
      "readers": {}
    }
  },
  "cdate": 1,
  "mdate": 1,
  "ddate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "tauthor": "text",
  "host": "text",
  "web": "text",
  "domain": "text",
  "anonids": true,
  "secret": "text",
  "invitations": [
    "text"
  ],
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatories": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "members": [
    "text"
  ],
  "deanonymizers": [
    "text"
  ],
  "impersonators": [
    "text"
  ],
  "details": {
    "writable": true
  }
}

Group response

Returns all the Group Edits by filter.

get

/groups/edits

Authorizations

Query parameters

idstring · min: 1

Edit id.

idsany of

Edit ids.

group.idstring · min: 1

Group id that the Edits have edited.

invitationstring · min: 1

Invitation id used to create the Edit(s).

trashboolean

Whether to get deleted Group Edits.

tauthorboolean

Get Edits authored by user.

writerstring · min: 1

Get Edits written by user.

signaturesany of

Get Edits signed by users.

selectstring · min: 1

Comma separated string with specific fields of the Note Edit object to return.

Example: id,content.title,content.abstract

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are writable, invitation, and all

Example: all

sortstring · min: 1

Sort returned Edits by field.

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Group Edits belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/groups/edits'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "edits": []
}

Edit Group response

Create or edit a Group Edit

post

/groups/edits

Authorizations

Body

idstring · min: 1

invitationstring · min: 1

tauthorstring · min: 1

contentobject

cdateinteger · max: 9999999999999

ddateinteger · max: 9999999999999

mdateinteger · max: 9999999999999

replacementboolean

groupobject

readersstring · min: 1[]

nonreadersstring · min: 1[]

writersstring · min: 1[]

signaturesstring · min: 1[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/groups/edits' \
  --header 'Content-Type: application/json'

200

default

200

{
  "id": "text",
  "invitation": "text",
  "content": {},
  "cdate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "ddate": 1,
  "mdate": 1,
  "group": {
    "id": "text",
    "cdate": 1,
    "ddate": 1,
    "mdate": 1,
    "tcdate": 1,
    "tmdate": 1,
    "tauthor": "text",
    "readers": [
      "text"
    ],
    "nonreaders": [
      "text"
    ],
    "writers": [
      "text"
    ],
    "signatories": [
      "text"
    ],
    "signatures": [
      "text"
    ],
    "host": "text",
    "web": "text",
    "domain": "text",
    "content": {
      "ANY_ADDITIONAL_PROPERTY": {
        "description": "text",
        "order": 1,
        "delete": true,
        "value": "text",
        "readers": {}
      }
    },
    "deanonymizers": [
      "text"
    ],
    "impersonators": [
      "text"
    ],
    "anonids": true,
    "members": [
      "text"
    ]
  },
  "domain": "text",
  "tauthor": "text",
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "details": {
    "writable": true,
    "invitation": {
      "id": "text",
      "content": {
        "ANY_ADDITIONAL_PROPERTY": {
          "description": "text",
          "order": 1,
          "delete": true,
          "value": "text",
          "readers": {}
        }
      },
      "domain": "text",
      "edge": {
        "invitation": "text",
        "head": "text",
        "tail": "text",
        "ddate": 1,
        "cdate": 1,
        "tcdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "id": "text",
        "label": "text",
        "weight": 1
      },
      "tag": {
        "id": "text",
        "invitation": "text",
        "forum": "text",
        "replyto": "text",
        "cdate": 1,
        "ddate": 1,
        "mdate": 1,
        "tcdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "details": {
          "forumContent": {
            "id": "text",
            "number": 1,
            "domain": "text",
            "forum": "text",
            "replyto": "text",
            "content": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "tcdate": 1,
            "tmdate": 1,
            "cdate": 1,
            "pdate": 1,
            "odate": 1,
            "ddate": 1,
            "mdate": 1,
            "forumContent": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "license": "text",
            "version": 1,
            "invitations": [
              "text"
            ],
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "details": "[Circular Reference]"
          }
        },
        "tag": "text"
      },
      "message": {
        "sendAt": 1,
        "subject": "text",
        "message": "text",
        "parentGroup": "text",
        "fromEmail": "text",
        "fromName": "text",
        "useJob": true,
        "groups": [
          "text"
        ],
        "ignoreGroups": [
          "text"
        ],
        "signature": "text",
        "replyTo": "text"
      },
      "tcdate": 1,
      "tmdate": 1,
      "cdate": 1,
      "mdate": 1,
      "ddate": 1,
      "duedate": 1,
      "expdate": 1,
      "taskCompletionCount": 1,
      "replyForumViews": [
        {
          "id": "text",
          "label": "text",
          "filter": "text",
          "sort": "text",
          "nesting": 1,
          "live": true,
          "layout": "text",
          "message": "text",
          "allowedInvitations": [
            "text"
          ],
          "expandedInvitations": [
            "text"
          ]
        }
      ],
      "dateprocesses": [
        {
          "script": "text",
          "cron": "text",
          "delay": 1,
          "dates": [
            1
          ],
          "startDate": 1,
          "endDate": 1
        }
      ],
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "invitees": [
        "text"
      ],
      "noninvitees": [
        "text"
      ],
      "type": "edge",
      "invitations": [
        "text"
      ],
      "edit": {
        "id": "text",
        "invitations": "text",
        "invitation": {
          "id": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "domain": "text",
          "edge": {
            "invitation": "text",
            "head": "text",
            "tail": "text",
            "ddate": 1,
            "cdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "id": "text",
            "label": "text",
            "weight": 1
          },
          "tag": {
            "id": "text",
            "invitation": "text",
            "forum": "text",
            "replyto": "text",
            "cdate": 1,
            "ddate": 1,
            "mdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "details": {
              "forumContent": {
                "id": "text",
                "number": 1,
                "domain": "text",
                "forum": "text",
                "replyto": "text",
                "content": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "tcdate": 1,
                "tmdate": 1,
                "cdate": 1,
                "pdate": 1,
                "odate": 1,
                "ddate": 1,
                "mdate": 1,
                "forumContent": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "license": "text",
                "version": 1,
                "invitations": [
                  "text"
                ],
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "details": "[Circular Reference]"
              }
            },
            "tag": "text"
          },
          "message": {
            "sendAt": 1,
            "subject": "text",
            "message": "text",
            "parentGroup": "text",
            "fromEmail": "text",
            "fromName": "text",
            "useJob": true,
            "groups": [
              "text"
            ],
            "ignoreGroups": [
              "text"
            ],
            "signature": "text",
            "replyTo": "text"
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "mdate": 1,
          "ddate": 1,
          "duedate": 1,
          "expdate": 1,
          "taskCompletionCount": 1,
          "replyForumViews": [
            {
              "id": "text",
              "label": "text",
              "filter": "text",
              "sort": "text",
              "nesting": 1,
              "live": true,
              "layout": "text",
              "message": "text",
              "allowedInvitations": [
                "text"
              ],
              "expandedInvitations": [
                "text"
              ]
            }
          ],
          "dateprocesses": [
            {
              "script": "text",
              "cron": "text",
              "delay": 1,
              "dates": [
                1
              ],
              "startDate": 1,
              "endDate": 1
            }
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "invitees": [
            "text"
          ],
          "noninvitees": [
            "text"
          ],
          "type": "edge",
          "invitations": [
            "text"
          ],
          "edit": "[Circular Reference]",
          "details": "[Circular Reference]",
          "responseArchiveDate": 1,
          "maxReplies": 1,
          "minReplies": 1,
          "preprocess": "text",
          "process": "text",
          "web": "text"
        },
        "content": {},
        "cdate": 1,
        "ddate": 1,
        "tcdate": 1,
        "mdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "replacement": true,
        "details": {
          "invitation": "[Circular Reference]",
          "writable": true
        }
      },
      "details": {
        "writable": true,
        "replytoNote": {
          "id": "text",
          "number": 1,
          "domain": "text",
          "forum": "text",
          "replyto": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "pdate": 1,
          "odate": 1,
          "ddate": 1,
          "mdate": 1,
          "forumContent": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "license": "text",
          "version": 1,
          "invitations": [
            "text"
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "details": {
            "replyCount": 1,
            "writable": true,
            "revisions": true,
            "forumContent": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "invitation": "[Circular Reference]",
            "directReplyCount": 1,
            "presentation": [
              {
                "name": "text",
                "order": 1,
                "fieldName": "text",
                "hidden": true,
                "markdown": true,
                "scroll": true,
                "input": "text",
                "default": "text",
                "value": "text",
                "description": "text"
              }
            ],
            "tags": "[Circular Reference]",
            "invitations": "[Circular Reference]",
            "directReplies": [
              {}
            ],
            "replies": [
              {}
            ],
            "signatures": [
              {
                "id": "text",
                "readers": [
                  "text"
                ],
                "members": [
                  "text"
                ]
              }
            ]
          }
        },
        "repliedNotes": [],
        "repliedEdits": [
          {
            "id": "text",
            "invitation": "text",
            "domain": "text",
            "content": {},
            "tcdate": 1,
            "tmdate": 1,
            "cdate": 1,
            "ddate": 1,
            "mdate": 1,
            "note": {
              "id": "text",
              "number": 1,
              "domain": "text",
              "forum": "text",
              "replyto": "text",
              "content": {},
              "tcdate": 1,
              "tmdate": 1,
              "cdate": 1,
              "pdate": 1,
              "odate": 1,
              "ddate": 1,
              "mdate": 1,
              "readers": [
                "text"
              ],
              "nonreaders": [
                "text"
              ],
              "writers": [
                "text"
              ],
              "signatures": [
                "text"
              ],
              "license": "text",
              "version": 1,
              "invitations": [
                "text"
              ]
            },
            "tauthor": "text",
            "replacement": true,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "details": "[Circular Reference]"
          }
        ],
        "repliedTags": [],
        "repliedEdges": [],
        "writableWith": []
      },
      "responseArchiveDate": 1,
      "maxReplies": 1,
      "minReplies": 1,
      "preprocess": "text",
      "process": "text",
      "web": "text"
    }
  }
}

Group Edit response

Returns all the Note Edits by filter.

get

/notes/edits

Authorizations

Query parameters

idstring · min: 1

Edit id.

idsany of

Edit ids.

note.idstring · min: 1

Note id that the Edits have edited.

invitationstring · min: 1

Invitation id used to create the Edit(s).

Example: ICLR.cc/2018/Conference/-/Blind_Submission

domainstring · min: 1

Domain of the Edits.

trashboolean

Whether to get deleted Note Edits.

tauthorboolean

Get Edits authored by user.

writerstring · min: 1

Get Edits written by user.

signaturesany of

Get Edits signed by users.

originalany of

get Edits that are originals

selectstring · min: 1

Comma separated string with specific fields of the Note Edit object to return.

Example: id,content.title,content.abstract

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are: replyCount: Number of replies in a forum. Only available if the Note is a forum. writable: Boolean indicating whether the Note is writable by the user. originalWritable: Boolean indicating whether the original Note is writable by the user. tags: Tags of the Note. invitations: Invitations of the Note. directReplyCount: Number of direct replies to the Note. directReplies: Direct replies to the Note. replies: Replies to the Note. Only available if the Note is a forum. forumContent: Content of the forum Note. Only available if the Note is a reply. presentation: Shows how to render the content of the Note. signatures: Returns members and readers of the signatures of the Note.

Example: all

sortstring · min: 1

Sort returned Edits by field.

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Note Edits belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/notes/edits'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "edits": [
    {
      "id": "text",
      "invitation": "text",
      "domain": "text",
      "content": {},
      "tcdate": 1,
      "tmdate": 1,
      "cdate": 1,
      "ddate": 1,
      "mdate": 1,
      "note": {
        "id": "text",
        "number": 1,
        "domain": "text",
        "forum": "text",
        "replyto": "text",
        "content": {},
        "tcdate": 1,
        "tmdate": 1,
        "cdate": 1,
        "pdate": 1,
        "odate": 1,
        "ddate": 1,
        "mdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "license": "text",
        "version": 1,
        "invitations": [
          "text"
        ]
      },
      "tauthor": "text",
      "replacement": true,
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "details": {
        "writable": true,
        "invitation": {
          "id": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "domain": "text",
          "edge": {
            "invitation": "text",
            "head": "text",
            "tail": "text",
            "ddate": 1,
            "cdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "id": "text",
            "label": "text",
            "weight": 1
          },
          "tag": {
            "id": "text",
            "invitation": "text",
            "forum": "text",
            "replyto": "text",
            "cdate": 1,
            "ddate": 1,
            "mdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "details": {
              "forumContent": {
                "id": "text",
                "number": 1,
                "domain": "text",
                "forum": "text",
                "replyto": "text",
                "content": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "tcdate": 1,
                "tmdate": 1,
                "cdate": 1,
                "pdate": 1,
                "odate": 1,
                "ddate": 1,
                "mdate": 1,
                "forumContent": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "license": "text",
                "version": 1,
                "invitations": [
                  "text"
                ],
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "details": "[Circular Reference]"
              }
            },
            "tag": "text"
          },
          "message": {
            "sendAt": 1,
            "subject": "text",
            "message": "text",
            "parentGroup": "text",
            "fromEmail": "text",
            "fromName": "text",
            "useJob": true,
            "groups": [
              "text"
            ],
            "ignoreGroups": [
              "text"
            ],
            "signature": "text",
            "replyTo": "text"
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "mdate": 1,
          "ddate": 1,
          "duedate": 1,
          "expdate": 1,
          "taskCompletionCount": 1,
          "replyForumViews": [
            {
              "id": "text",
              "label": "text",
              "filter": "text",
              "sort": "text",
              "nesting": 1,
              "live": true,
              "layout": "text",
              "message": "text",
              "allowedInvitations": [
                "text"
              ],
              "expandedInvitations": [
                "text"
              ]
            }
          ],
          "dateprocesses": [
            {
              "script": "text",
              "cron": "text",
              "delay": 1,
              "dates": [
                1
              ],
              "startDate": 1,
              "endDate": 1
            }
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "invitees": [
            "text"
          ],
          "noninvitees": [
            "text"
          ],
          "type": "edge",
          "invitations": [
            "text"
          ],
          "edit": {
            "id": "text",
            "invitations": "text",
            "invitation": {
              "id": "text",
              "content": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "description": "text",
                  "order": 1,
                  "delete": true,
                  "value": "text",
                  "readers": {}
                }
              },
              "domain": "text",
              "edge": {
                "invitation": "text",
                "head": "text",
                "tail": "text",
                "ddate": 1,
                "cdate": 1,
                "tcdate": 1,
                "tmdate": 1,
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "tauthor": "text",
                "domain": "text",
                "id": "text",
                "label": "text",
                "weight": 1
              },
              "tag": {
                "id": "text",
                "invitation": "text",
                "forum": "text",
                "replyto": "text",
                "cdate": 1,
                "ddate": 1,
                "mdate": 1,
                "tcdate": 1,
                "tmdate": 1,
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "tauthor": "text",
                "domain": "text",
                "details": {
                  "forumContent": {
                    "id": "text",
                    "number": 1,
                    "domain": "text",
                    "forum": "text",
                    "replyto": "text",
                    "content": {
                      "ANY_ADDITIONAL_PROPERTY": {
                        "description": "text",
                        "order": 1,
                        "delete": true,
                        "value": "text",
                        "readers": {}
                      }
                    },
                    "tcdate": 1,
                    "tmdate": 1,
                    "cdate": 1,
                    "pdate": 1,
                    "odate": 1,
                    "ddate": 1,
                    "mdate": 1,
                    "forumContent": {
                      "ANY_ADDITIONAL_PROPERTY": {
                        "description": "text",
                        "order": 1,
                        "delete": true,
                        "value": "text",
                        "readers": {}
                      }
                    },
                    "license": "text",
                    "version": 1,
                    "invitations": [
                      "text"
                    ],
                    "readers": [
                      "text"
                    ],
                    "nonreaders": [
                      "text"
                    ],
                    "writers": [
                      "text"
                    ],
                    "signatures": [
                      "text"
                    ],
                    "details": "[Circular Reference]"
                  }
                },
                "tag": "text"
              },
              "message": {
                "sendAt": 1,
                "subject": "text",
                "message": "text",
                "parentGroup": "text",
                "fromEmail": "text",
                "fromName": "text",
                "useJob": true,
                "groups": [
                  "text"
                ],
                "ignoreGroups": [
                  "text"
                ],
                "signature": "text",
                "replyTo": "text"
              },
              "tcdate": 1,
              "tmdate": 1,
              "cdate": 1,
              "mdate": 1,
              "ddate": 1,
              "duedate": 1,
              "expdate": 1,
              "taskCompletionCount": 1,
              "replyForumViews": [
                {
                  "id": "text",
                  "label": "text",
                  "filter": "text",
                  "sort": "text",
                  "nesting": 1,
                  "live": true,
                  "layout": "text",
                  "message": "text",
                  "allowedInvitations": [
                    "text"
                  ],
                  "expandedInvitations": [
                    "text"
                  ]
                }
              ],
              "dateprocesses": [
                {
                  "script": "text",
                  "cron": "text",
                  "delay": 1,
                  "dates": [
                    1
                  ],
                  "startDate": 1,
                  "endDate": 1
                }
              ],
              "readers": [
                "text"
              ],
              "nonreaders": [
                "text"
              ],
              "writers": [
                "text"
              ],
              "signatures": [
                "text"
              ],
              "invitees": [
                "text"
              ],
              "noninvitees": [
                "text"
              ],
              "type": "edge",
              "invitations": [
                "text"
              ],
              "edit": "[Circular Reference]",
              "details": "[Circular Reference]",
              "responseArchiveDate": 1,
              "maxReplies": 1,
              "minReplies": 1,
              "preprocess": "text",
              "process": "text",
              "web": "text"
            },
            "content": {},
            "cdate": 1,
            "ddate": 1,
            "tcdate": 1,
            "mdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "replacement": true,
            "details": {
              "invitation": "[Circular Reference]",
              "writable": true
            }
          },
          "details": {
            "writable": true,
            "replytoNote": {
              "id": "text",
              "number": 1,
              "domain": "text",
              "forum": "text",
              "replyto": "text",
              "content": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "description": "text",
                  "order": 1,
                  "delete": true,
                  "value": "text",
                  "readers": {}
                }
              },
              "tcdate": 1,
              "tmdate": 1,
              "cdate": 1,
              "pdate": 1,
              "odate": 1,
              "ddate": 1,
              "mdate": 1,
              "forumContent": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "description": "text",
                  "order": 1,
                  "delete": true,
                  "value": "text",
                  "readers": {}
                }
              },
              "license": "text",
              "version": 1,
              "invitations": [
                "text"
              ],
              "readers": [
                "text"
              ],
              "nonreaders": [
                "text"
              ],
              "writers": [
                "text"
              ],
              "signatures": [
                "text"
              ],
              "details": {
                "replyCount": 1,
                "writable": true,
                "revisions": true,
                "forumContent": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "invitation": "[Circular Reference]",
                "directReplyCount": 1,
                "presentation": [
                  {
                    "name": "text",
                    "order": 1,
                    "fieldName": "text",
                    "hidden": true,
                    "markdown": true,
                    "scroll": true,
                    "input": "text",
                    "default": "text",
                    "value": "text",
                    "description": "text"
                  }
                ],
                "tags": "[Circular Reference]",
                "invitations": "[Circular Reference]",
                "directReplies": [
                  {}
                ],
                "replies": [
                  {}
                ],
                "signatures": [
                  {
                    "id": "text",
                    "readers": [
                      "text"
                    ],
                    "members": [
                      "text"
                    ]
                  }
                ]
              }
            },
            "repliedNotes": [],
            "repliedEdits": [
              {
                "id": "text",
                "invitation": "text",
                "domain": "text",
                "content": {},
                "tcdate": 1,
                "tmdate": 1,
                "cdate": 1,
                "ddate": 1,
                "mdate": 1,
                "note": {
                  "id": "text",
                  "number": 1,
                  "domain": "text",
                  "forum": "text",
                  "replyto": "text",
                  "content": {},
                  "tcdate": 1,
                  "tmdate": 1,
                  "cdate": 1,
                  "pdate": 1,
                  "odate": 1,
                  "ddate": 1,
                  "mdate": 1,
                  "readers": [
                    "text"
                  ],
                  "nonreaders": [
                    "text"
                  ],
                  "writers": [
                    "text"
                  ],
                  "signatures": [
                    "text"
                  ],
                  "license": "text",
                  "version": 1,
                  "invitations": [
                    "text"
                  ]
                },
                "tauthor": "text",
                "replacement": true,
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "details": "[Circular Reference]"
              }
            ],
            "repliedTags": [],
            "repliedEdges": [],
            "writableWith": []
          },
          "responseArchiveDate": 1,
          "maxReplies": 1,
          "minReplies": 1,
          "preprocess": "text",
          "process": "text",
          "web": "text"
        },
        "presentation": [
          {
            "name": "text",
            "order": 1,
            "fieldName": "text",
            "hidden": true,
            "markdown": true,
            "scroll": true,
            "input": "text",
            "default": "text",
            "value": "text",
            "description": "text"
          }
        ]
      }
    }
  ]
}

Edit Note response

Create or edit a Note Edit

post

/notes/edits

Authorizations

Body

idstring · min: 1

invitationstring · min: 1

tauthorstring · min: 1

contentobject

cdateinteger · max: 9999999999999

ddateinteger · max: 9999999999999

mdateinteger · max: 9999999999999

replacementboolean

noteobject

readersstring · min: 1[]

nonreadersstring · min: 1[]

writersstring · min: 1[]

signaturesstring · min: 1[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/notes/edits' \
  --header 'Content-Type: application/json'

200

default

200

{
  "id": "text",
  "invitation": "text",
  "domain": "text",
  "content": {},
  "tcdate": 1,
  "tmdate": 1,
  "cdate": 1,
  "ddate": 1,
  "mdate": 1,
  "note": {
    "id": "text",
    "number": 1,
    "domain": "text",
    "forum": "text",
    "replyto": "text",
    "content": {},
    "tcdate": 1,
    "tmdate": 1,
    "cdate": 1,
    "pdate": 1,
    "odate": 1,
    "ddate": 1,
    "mdate": 1,
    "readers": [
      "text"
    ],
    "nonreaders": [
      "text"
    ],
    "writers": [
      "text"
    ],
    "signatures": [
      "text"
    ],
    "license": "text",
    "version": 1,
    "invitations": [
      "text"
    ]
  },
  "tauthor": "text",
  "replacement": true,
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "details": {
    "writable": true,
    "invitation": {
      "id": "text",
      "content": {
        "ANY_ADDITIONAL_PROPERTY": {
          "description": "text",
          "order": 1,
          "delete": true,
          "value": "text",
          "readers": {}
        }
      },
      "domain": "text",
      "edge": {
        "invitation": "text",
        "head": "text",
        "tail": "text",
        "ddate": 1,
        "cdate": 1,
        "tcdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "id": "text",
        "label": "text",
        "weight": 1
      },
      "tag": {
        "id": "text",
        "invitation": "text",
        "forum": "text",
        "replyto": "text",
        "cdate": 1,
        "ddate": 1,
        "mdate": 1,
        "tcdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "details": {
          "forumContent": {
            "id": "text",
            "number": 1,
            "domain": "text",
            "forum": "text",
            "replyto": "text",
            "content": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "tcdate": 1,
            "tmdate": 1,
            "cdate": 1,
            "pdate": 1,
            "odate": 1,
            "ddate": 1,
            "mdate": 1,
            "forumContent": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "license": "text",
            "version": 1,
            "invitations": [
              "text"
            ],
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "details": "[Circular Reference]"
          }
        },
        "tag": "text"
      },
      "message": {
        "sendAt": 1,
        "subject": "text",
        "message": "text",
        "parentGroup": "text",
        "fromEmail": "text",
        "fromName": "text",
        "useJob": true,
        "groups": [
          "text"
        ],
        "ignoreGroups": [
          "text"
        ],
        "signature": "text",
        "replyTo": "text"
      },
      "tcdate": 1,
      "tmdate": 1,
      "cdate": 1,
      "mdate": 1,
      "ddate": 1,
      "duedate": 1,
      "expdate": 1,
      "taskCompletionCount": 1,
      "replyForumViews": [
        {
          "id": "text",
          "label": "text",
          "filter": "text",
          "sort": "text",
          "nesting": 1,
          "live": true,
          "layout": "text",
          "message": "text",
          "allowedInvitations": [
            "text"
          ],
          "expandedInvitations": [
            "text"
          ]
        }
      ],
      "dateprocesses": [
        {
          "script": "text",
          "cron": "text",
          "delay": 1,
          "dates": [
            1
          ],
          "startDate": 1,
          "endDate": 1
        }
      ],
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "invitees": [
        "text"
      ],
      "noninvitees": [
        "text"
      ],
      "type": "edge",
      "invitations": [
        "text"
      ],
      "edit": {
        "id": "text",
        "invitations": "text",
        "invitation": {
          "id": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "domain": "text",
          "edge": {
            "invitation": "text",
            "head": "text",
            "tail": "text",
            "ddate": 1,
            "cdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "id": "text",
            "label": "text",
            "weight": 1
          },
          "tag": {
            "id": "text",
            "invitation": "text",
            "forum": "text",
            "replyto": "text",
            "cdate": 1,
            "ddate": 1,
            "mdate": 1,
            "tcdate": 1,
            "tmdate": 1,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "tauthor": "text",
            "domain": "text",
            "details": {
              "forumContent": {
                "id": "text",
                "number": 1,
                "domain": "text",
                "forum": "text",
                "replyto": "text",
                "content": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "tcdate": 1,
                "tmdate": 1,
                "cdate": 1,
                "pdate": 1,
                "odate": 1,
                "ddate": 1,
                "mdate": 1,
                "forumContent": {
                  "ANY_ADDITIONAL_PROPERTY": {
                    "description": "text",
                    "order": 1,
                    "delete": true,
                    "value": "text",
                    "readers": {}
                  }
                },
                "license": "text",
                "version": 1,
                "invitations": [
                  "text"
                ],
                "readers": [
                  "text"
                ],
                "nonreaders": [
                  "text"
                ],
                "writers": [
                  "text"
                ],
                "signatures": [
                  "text"
                ],
                "details": "[Circular Reference]"
              }
            },
            "tag": "text"
          },
          "message": {
            "sendAt": 1,
            "subject": "text",
            "message": "text",
            "parentGroup": "text",
            "fromEmail": "text",
            "fromName": "text",
            "useJob": true,
            "groups": [
              "text"
            ],
            "ignoreGroups": [
              "text"
            ],
            "signature": "text",
            "replyTo": "text"
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "mdate": 1,
          "ddate": 1,
          "duedate": 1,
          "expdate": 1,
          "taskCompletionCount": 1,
          "replyForumViews": [
            {
              "id": "text",
              "label": "text",
              "filter": "text",
              "sort": "text",
              "nesting": 1,
              "live": true,
              "layout": "text",
              "message": "text",
              "allowedInvitations": [
                "text"
              ],
              "expandedInvitations": [
                "text"
              ]
            }
          ],
          "dateprocesses": [
            {
              "script": "text",
              "cron": "text",
              "delay": 1,
              "dates": [
                1
              ],
              "startDate": 1,
              "endDate": 1
            }
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "invitees": [
            "text"
          ],
          "noninvitees": [
            "text"
          ],
          "type": "edge",
          "invitations": [
            "text"
          ],
          "edit": "[Circular Reference]",
          "details": "[Circular Reference]",
          "responseArchiveDate": 1,
          "maxReplies": 1,
          "minReplies": 1,
          "preprocess": "text",
          "process": "text",
          "web": "text"
        },
        "content": {},
        "cdate": 1,
        "ddate": 1,
        "tcdate": 1,
        "mdate": 1,
        "tmdate": 1,
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "tauthor": "text",
        "domain": "text",
        "replacement": true,
        "details": {
          "invitation": "[Circular Reference]",
          "writable": true
        }
      },
      "details": {
        "writable": true,
        "replytoNote": {
          "id": "text",
          "number": 1,
          "domain": "text",
          "forum": "text",
          "replyto": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "pdate": 1,
          "odate": 1,
          "ddate": 1,
          "mdate": 1,
          "forumContent": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "license": "text",
          "version": 1,
          "invitations": [
            "text"
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "details": {
            "replyCount": 1,
            "writable": true,
            "revisions": true,
            "forumContent": {
              "ANY_ADDITIONAL_PROPERTY": {
                "description": "text",
                "order": 1,
                "delete": true,
                "value": "text",
                "readers": {}
              }
            },
            "invitation": "[Circular Reference]",
            "directReplyCount": 1,
            "presentation": [
              {
                "name": "text",
                "order": 1,
                "fieldName": "text",
                "hidden": true,
                "markdown": true,
                "scroll": true,
                "input": "text",
                "default": "text",
                "value": "text",
                "description": "text"
              }
            ],
            "tags": "[Circular Reference]",
            "invitations": "[Circular Reference]",
            "directReplies": [
              {}
            ],
            "replies": [
              {}
            ],
            "signatures": [
              {
                "id": "text",
                "readers": [
                  "text"
                ],
                "members": [
                  "text"
                ]
              }
            ]
          }
        },
        "repliedNotes": [],
        "repliedEdits": [
          {
            "id": "text",
            "invitation": "text",
            "domain": "text",
            "content": {},
            "tcdate": 1,
            "tmdate": 1,
            "cdate": 1,
            "ddate": 1,
            "mdate": 1,
            "note": {
              "id": "text",
              "number": 1,
              "domain": "text",
              "forum": "text",
              "replyto": "text",
              "content": {},
              "tcdate": 1,
              "tmdate": 1,
              "cdate": 1,
              "pdate": 1,
              "odate": 1,
              "ddate": 1,
              "mdate": 1,
              "readers": [
                "text"
              ],
              "nonreaders": [
                "text"
              ],
              "writers": [
                "text"
              ],
              "signatures": [
                "text"
              ],
              "license": "text",
              "version": 1,
              "invitations": [
                "text"
              ]
            },
            "tauthor": "text",
            "replacement": true,
            "readers": [
              "text"
            ],
            "nonreaders": [
              "text"
            ],
            "writers": [
              "text"
            ],
            "signatures": [
              "text"
            ],
            "details": "[Circular Reference]"
          }
        ],
        "repliedTags": [],
        "repliedEdges": [],
        "writableWith": []
      },
      "responseArchiveDate": 1,
      "maxReplies": 1,
      "minReplies": 1,
      "preprocess": "text",
      "process": "text",
      "web": "text"
    },
    "presentation": [
      {
        "name": "text",
        "order": 1,
        "fieldName": "text",
        "hidden": true,
        "markdown": true,
        "scroll": true,
        "input": "text",
        "default": "text",
        "value": "text",
        "description": "text"
      }
    ]
  }
}

Note Edit response

Returns all the Notes by filter.

get

/notes

Authorizations

Query parameters

idstring · min: 1

Note id.

idsany of

Note ids.

invitationstring · min: 1

Invitation id used to create the Note(s).

Example: ICLR.cc/2018/Conference/-/Blind_Submission

invitationsany of

Invitation ids.

forumany of

Note id of the forum field.

replytoany of

Note id of the replyto field.

numberany of

Note number.

content.titlestring · min: 1

Note title.

content.confidencestring · min: 1

Note content confidence field value.

content.strengthsstring · min: 1

Note content strengths field value.

content.weaknessesstring · min: 1

Note content weaknesses field value.

content.decisionstring · min: 1

Note content decision field value.

content.certificationsstring · min: 1

Note content certification field values.

content.previous_URLstring · min: 1

Note content previous_URL field value.

content.userstring · min: 1

User email in recruitment.

content.responsestring · min: 1

User response in recruitment.

content.submission_idstring · min: 1

content.venuestring · min: 1

Note venue.

content.venueidstring · min: 1

Note venueid.

content.venue_idstring · min: 1

Note venue_id.

content.presentation_typestring · min: 1

Presentation Type.

content.sessionsstring · min: 1

Sessions.

content.trackstring · min: 1

Track.

content.authoridsany of

List of tilde ids of registered users or of emails either registered or not.

trashboolean

Whether to get deleted Notes.

paperhashstringDeprecated

paperhash of the Note if exists.

Example: das|go_for_a_walk_and_arrive_at_the_answer_reasoning_over_paths_in_knowledge_bases_using_reinforcement_learning.

tauthorboolean

Get Notes authored by user.

writerstring · min: 1

Get Notes written by user.

signaturestring · min: 1

Get Notes signed by user.

transitiveMembersboolean

Include transitive members of signature if it's passed as a parameter.

signaturesany of

Get Notes signed by users.

originalany of

get Notes that are originals

selectstring · min: 1

Comma separated string with specific fields of the Note object to return.

Example: id,content.title,content.abstract

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are replyCount, original, overwriting, revisions, writable, forumContent, tags, revisions, invitation, directReplyCount, directReplies, replies, and all

Example: all

inviteeboolean

invitee

mintcdateinteger

minimum creation date

mintmdateinteger

minimum modification date

duedateboolean

due date

sortstring · min: 1

Sort returned Notes by field.

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Notes belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/notes'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "notes": []
}

Note response

Search Notes

get

/notes/search

Authorizations

Query parameters

querystring · min: 1

Search query that that looks inside some of the fields in the content of the Note.

termstring · min: 1

Search term that that looks inside some of the fields in the content of the Note.

termsstring · min: 1[]

Search term that that looks inside some of the fields in the content of the Note.

typestring · enum

Search type

Options: prefix, terms, exact

contentstring · enum · default: all

Fields inside content to look for the term.

Options: title, abstract, authors, authorids, comment, review, paperhash, confidence, summary, main_review, metareview, strengths, weaknesses, TL;DR, decision, recommendation, venueid, venue, keywords, subject_areas, all

groupstring · min: 1

Group that the Invitation belongs to

sourcestring · enum · default: all

Source of the Note

Options: forum, reply, all

invitationstring · min: 1

Invitation id used to create the Note(s).

Example: ICLR.cc/2018/Conference/-/Submission

venuestring · min: 1

Venue of the Note

venueidstring · min: 1

Venue id of the Note

sortstring · min: 1

Sort returned Notes by field.

Example: tmdate:desc

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Notes belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/notes/search'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "notes": []
}

Note response

Search Notes Post

post

/notes/search

Authorizations

Body

querystring · min: 1

Search query that that looks inside some of the fields in the content of the Note.

termstring · min: 1

groupstring · min: 1

Group that the Invitation belongs to

invitationstring · min: 1

Invitation id used to create the Note(s).

venuestring · min: 1

Venue of the Note

venueidstring · min: 1

Venue id of the Note

domainstring · min: 1

Domain the Notes belong.

sortstring · min: 1

Sort returned Notes by field.

Example: tmdate:desc

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

typestring · enum

Search type

Options: prefix, terms

sourcestring · enum · default: all

Source of the Note

Options: forum, reply, all

idsstring · min: 1[]

Note ids.

termsstring · min: 1[]

contentobject

Fields inside content to look for the term.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/notes/search' \
  --header 'Content-Type: application/json' \
  --data '{"sort":"tmdate:desc","type":"prefix","source":"all","ids":[null],"terms":[null],"content":{"title":{"matchMethod":"match","terms":[null]},"venue":{"matchMethod":"match","terms":[null]}}}'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "notes": []
}

Note response

Returns Invitation Edits

get

/invitations/edits

Authorizations

Query parameters

idstring · min: 1

Edit id.

idsany of

Edit ids.

invitation.idstring · min: 1

Invitation id that the Edits have edited.

invitationstring · min: 1

Invitation id used to create the Edit(s).

Example: ICLR.cc/2018/Conference/-/Blind_Submission

trashboolean

Whether to get deleted Invitation Edits.

tauthorboolean

Get Edits authored by user.

writerstring · min: 1

Get Edits written by user.

signaturesany of

Get Edits signed by users.

originalany of

get Edits that are originals

selectstring · min: 1

Comma separated string with specific fields of the Invitation Edit object to return.

Example: id,content.title,content.abstract

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are writable, invitation, presentation, and all

Example: all

sortstring · min: 1

Sort returned Edits by field.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Invitation Edits belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/invitations/edits'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "edits": [
    {
      "id": "text",
      "invitations": "text",
      "invitation": {
        "id": "text",
        "content": {
          "ANY_ADDITIONAL_PROPERTY": {
            "description": "text",
            "order": 1,
            "delete": true,
            "value": "text",
            "readers": {}
          }
        },
        "domain": "text",
        "edge": {
          "invitation": "text",
          "head": "text",
          "tail": "text",
          "ddate": 1,
          "cdate": 1,
          "tcdate": 1,
          "tmdate": 1,
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "tauthor": "text",
          "domain": "text",
          "id": "text",
          "label": "text",
          "weight": 1
        },
        "tag": {
          "id": "text",
          "invitation": "text",
          "forum": "text",
          "replyto": "text",
          "cdate": 1,
          "ddate": 1,
          "mdate": 1,
          "tcdate": 1,
          "tmdate": 1,
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "tauthor": "text",
          "domain": "text",
          "details": {
            "forumContent": {
              "id": "text",
              "number": 1,
              "domain": "text",
              "forum": "text",
              "replyto": "text",
              "content": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "description": "text",
                  "order": 1,
                  "delete": true,
                  "value": "text",
                  "readers": {}
                }
              },
              "tcdate": 1,
              "tmdate": 1,
              "cdate": 1,
              "pdate": 1,
              "odate": 1,
              "ddate": 1,
              "mdate": 1,
              "forumContent": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "description": "text",
                  "order": 1,
                  "delete": true,
                  "value": "text",
                  "readers": {}
                }
              },
              "license": "text",
              "version": 1,
              "invitations": [
                "text"
              ],
              "readers": [
                "text"
              ],
              "nonreaders": [
                "text"
              ],
              "writers": [
                "text"
              ],
              "signatures": [
                "text"
              ],
              "details": "[Circular Reference]"
            }
          },
          "tag": "text"
        },
        "message": {
          "sendAt": 1,
          "subject": "text",
          "message": "text",
          "parentGroup": "text",
          "fromEmail": "text",
          "fromName": "text",
          "useJob": true,
          "groups": [
            "text"
          ],
          "ignoreGroups": [
            "text"
          ],
          "signature": "text",
          "replyTo": "text"
        },
        "tcdate": 1,
        "tmdate": 1,
        "cdate": 1,
        "mdate": 1,
        "ddate": 1,
        "duedate": 1,
        "expdate": 1,
        "taskCompletionCount": 1,
        "replyForumViews": [
          {
            "id": "text",
            "label": "text",
            "filter": "text",
            "sort": "text",
            "nesting": 1,
            "live": true,
            "layout": "text",
            "message": "text",
            "allowedInvitations": [
              "text"
            ],
            "expandedInvitations": [
              "text"
            ]
          }
        ],
        "dateprocesses": [
          {
            "script": "text",
            "cron": "text",
            "delay": 1,
            "dates": [
              1
            ],
            "startDate": 1,
            "endDate": 1
          }
        ],
        "readers": [
          "text"
        ],
        "nonreaders": [
          "text"
        ],
        "writers": [
          "text"
        ],
        "signatures": [
          "text"
        ],
        "invitees": [
          "text"
        ],
        "noninvitees": [
          "text"
        ],
        "type": "edge",
        "invitations": [
          "text"
        ],
        "edit": "[Circular Reference]",
        "details": "[Circular Reference]",
        "responseArchiveDate": 1,
        "maxReplies": 1,
        "minReplies": 1,
        "preprocess": "text",
        "process": "text",
        "web": "text"
      },
      "content": {},
      "cdate": 1,
      "ddate": 1,
      "tcdate": 1,
      "mdate": 1,
      "tmdate": 1,
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "tauthor": "text",
      "domain": "text",
      "replacement": true,
      "details": {
        "invitation": "[Circular Reference]",
        "writable": true
      }
    }
  ]
}

Invitation response

Create or edit a Invitation Edit

post

/invitations/edits

Authorizations

Body

idstring · min: 1

invitationsstring · min: 1

replacementboolean

contentobject

invitationobject

cdateinteger · max: 9999999999999

mdateinteger · max: 9999999999999

ddateinteger · max: 9999999999999

readersstring · min: 1[]

nonreadersstring · min: 1[]

writersstring · min: 1[]

signaturesstring · min: 1[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/invitations/edits' \
  --header 'Content-Type: application/json'

200

default

200

{
  "id": "text",
  "invitations": "text",
  "invitation": {
    "id": "text",
    "content": {
      "ANY_ADDITIONAL_PROPERTY": {
        "description": "text",
        "order": 1,
        "delete": true,
        "value": "text",
        "readers": {}
      }
    },
    "domain": "text",
    "edge": {
      "invitation": "text",
      "head": "text",
      "tail": "text",
      "ddate": 1,
      "cdate": 1,
      "tcdate": 1,
      "tmdate": 1,
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "tauthor": "text",
      "domain": "text",
      "id": "text",
      "label": "text",
      "weight": 1
    },
    "tag": {
      "id": "text",
      "invitation": "text",
      "forum": "text",
      "replyto": "text",
      "cdate": 1,
      "ddate": 1,
      "mdate": 1,
      "tcdate": 1,
      "tmdate": 1,
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "tauthor": "text",
      "domain": "text",
      "details": {
        "forumContent": {
          "id": "text",
          "number": 1,
          "domain": "text",
          "forum": "text",
          "replyto": "text",
          "content": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "tcdate": 1,
          "tmdate": 1,
          "cdate": 1,
          "pdate": 1,
          "odate": 1,
          "ddate": 1,
          "mdate": 1,
          "forumContent": {
            "ANY_ADDITIONAL_PROPERTY": {
              "description": "text",
              "order": 1,
              "delete": true,
              "value": "text",
              "readers": {}
            }
          },
          "license": "text",
          "version": 1,
          "invitations": [
            "text"
          ],
          "readers": [
            "text"
          ],
          "nonreaders": [
            "text"
          ],
          "writers": [
            "text"
          ],
          "signatures": [
            "text"
          ],
          "details": "[Circular Reference]"
        }
      },
      "tag": "text"
    },
    "message": {
      "sendAt": 1,
      "subject": "text",
      "message": "text",
      "parentGroup": "text",
      "fromEmail": "text",
      "fromName": "text",
      "useJob": true,
      "groups": [
        "text"
      ],
      "ignoreGroups": [
        "text"
      ],
      "signature": "text",
      "replyTo": "text"
    },
    "tcdate": 1,
    "tmdate": 1,
    "cdate": 1,
    "mdate": 1,
    "ddate": 1,
    "duedate": 1,
    "expdate": 1,
    "taskCompletionCount": 1,
    "replyForumViews": [
      {
        "id": "text",
        "label": "text",
        "filter": "text",
        "sort": "text",
        "nesting": 1,
        "live": true,
        "layout": "text",
        "message": "text",
        "allowedInvitations": [
          "text"
        ],
        "expandedInvitations": [
          "text"
        ]
      }
    ],
    "dateprocesses": [
      {
        "script": "text",
        "cron": "text",
        "delay": 1,
        "dates": [
          1
        ],
        "startDate": 1,
        "endDate": 1
      }
    ],
    "readers": [
      "text"
    ],
    "nonreaders": [
      "text"
    ],
    "writers": [
      "text"
    ],
    "signatures": [
      "text"
    ],
    "invitees": [
      "text"
    ],
    "noninvitees": [
      "text"
    ],
    "type": "edge",
    "invitations": [
      "text"
    ],
    "edit": "[Circular Reference]",
    "details": "[Circular Reference]",
    "responseArchiveDate": 1,
    "maxReplies": 1,
    "minReplies": 1,
    "preprocess": "text",
    "process": "text",
    "web": "text"
  },
  "content": {},
  "cdate": 1,
  "ddate": 1,
  "tcdate": 1,
  "mdate": 1,
  "tmdate": 1,
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "tauthor": "text",
  "domain": "text",
  "replacement": true,
  "details": {
    "invitation": "[Circular Reference]",
    "writable": true
  }
}

Invitation Edit response

Returns Invitations

get

/invitations

Authorizations

Query parameters

idstring · min: 1

Invitation id

idsany of

Invitation ids

invitationstring · min: 1

Invitation used to validate this invitation.

prefixstring · min: 1

Invitation id prefix

domainstring · min: 1

Invitation domain

typestring · enum

Invitation type

Options: note, notes, tag, tags, edge, edges, group, groups, invitation, invitations, meta, all

replyForumstring · min: 1

Note id

replyInvitationstring · min: 1

Invitation id

minduedateinteger

minimum due date of the Invitation

inviteeany of

invitee id

signaturestring · min: 1

Invitation signature

replytoboolean

Invitations should have replyto field

duedateboolean

Invitations should have due date

pastdueboolean

Invitations should be past due

expiredboolean

Invitations should be expired

selectstring · min: 1

Comma separated string with specific fields of the Invitation object to return.

Example: id,content,readers,invitees

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are replytoNote, repliedNotes, repliedTags, repliedEdges, all.

tagsbooleanDeprecated

Get only Tag Invitations

edgesbooleanDeprecated

Get only edge Invitations

notesbooleanDeprecated

Get only Note Invitations

sortstring · min: 1

Sort returned Invitations by field.

limitinteger · min: 1

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

domainstring · min: 1

Domain the Invitations belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/invitations'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "invitations": []
}

Invitation response

Find tags by different filters

get

/tags

Authorizations

Query parameters

idstring

Tag id

idsany of

Tag ids

invitationstring

Invitation id used to create the Tag(s).

Example: ICLR.cc/2018/Conference/-/Add_Bid

tagstring · min: 1

Tag value

signaturestring · min: 1

Tag signature

forumstring

Note id of the forum field.

replytostring

Invitations should have replyto field

trashboolean

Get tags deleted too.

tauthorboolean

Get tags authored by user.

detailsstring · min: 1

Comma separated values of fields to add to details. Valid values are forumContent, all.

limitinteger · default: 1000

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

domainstring · min: 1

Domain the Tags belong to to filter transitive members.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/tags'

200

default

200

{
  "count": 1,
  "fromCache": true,
  "tags": []
}

Tag response

Create or edit a Tag

post

/tags

Authorizations

Body

idany of

invitationstring · min: 1

forumany ofrequired

replytoany of

cdateany of

ddateany of

mdateany of

tcdateinteger · max: 9999999999999

tmdateinteger · max: 9999999999999

readersany of

nonreadersany of

writersany of

signaturesany ofrequired

tauthorstring · min: 1

domainstring · min: 1

detailsobject

tagany ofrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/tags' \
  --header 'Content-Type: application/json' \
  --data '{"invitation":"ICLR.cc/2018/Conference/-/Add_Bid","forum":"SJeI6e62XQ","tag":"I want to review","readers":["everyone"],"signatures":["~Super_User1"]}'

200

default

200

{
  "id": "text",
  "invitation": "text",
  "forum": "text",
  "replyto": "text",
  "cdate": 1,
  "ddate": 1,
  "mdate": 1,
  "tcdate": 1,
  "tmdate": 1,
  "readers": [
    "text"
  ],
  "nonreaders": [
    "text"
  ],
  "writers": [
    "text"
  ],
  "signatures": [
    "text"
  ],
  "tauthor": "text",
  "domain": "text",
  "details": {
    "forumContent": {
      "id": "text",
      "number": 1,
      "domain": "text",
      "forum": "text",
      "replyto": "text",
      "content": {
        "ANY_ADDITIONAL_PROPERTY": {
          "description": "text",
          "order": 1,
          "delete": true,
          "value": "text",
          "readers": {}
        }
      },
      "tcdate": 1,
      "tmdate": 1,
      "cdate": 1,
      "pdate": 1,
      "odate": 1,
      "ddate": 1,
      "mdate": 1,
      "forumContent": {
        "ANY_ADDITIONAL_PROPERTY": {
          "description": "text",
          "order": 1,
          "delete": true,
          "value": "text",
          "readers": {}
        }
      },
      "license": "text",
      "version": 1,
      "invitations": [
        "text"
      ],
      "readers": [
        "text"
      ],
      "nonreaders": [
        "text"
      ],
      "writers": [
        "text"
      ],
      "signatures": [
        "text"
      ],
      "details": "[Circular Reference]"
    }
  },
  "tag": "text"
}

Tag response

Find messages by different filters

get

/messages

Authorizations

Query parameters

idstring · min: 1

Message id.

jobIdstring · min: 1

Job id used to send Messages.

tostring · min: 1

Email address of the recipient.

transitiveMembersboolean

Whether to include transitive members of the group in the to field.

subjectstring · min: 1

Subject of the Message.

parentGroupstring · min: 1

Parent Group the recipients belongs to.

statusany of

Status of the message.

tauthorstring · min: 1

Email of the author of the message.

viewedboolean

Whether the message has been viewed.

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/messages'

200

default

200

{
  "count": 1,
  "messages": []
}

message response

Create a direct message

post

/messages

Authorizations

Body

fromNamestring

Name of the sender.

fromEmailstring

Email of the sender.

subjectstringrequired

Subject of the message.

messagestringrequired

Message body.

parentGroupstring | nullable

Parent group that the groups belong to.

invitationstring

Invitation used to validate message

signaturestring

Signature of the message.

sendAtinteger | nullable

Send the message at a specific UTC time in milliseconds in the future. Maximum is 70 hours.

replyTostring | nullable

Email address the recipient should replyto.

useJobboolean | nullable

Whether to wait for messages to be sent.

groupsstring · min: 1[]required

Groups the message is sent to.

ignoreGroupsstring · min: 1[] · default: | nullable

Groups the message should not be sent to.

fromobject | nullable

Email address the message is sent from.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/messages' \
  --header 'Content-Type: application/json' \
  --data '{"subject":"text","message":"text","groups":[null],"ignoreGroups":[],"from":{}}'

200

default

200

{
  "status": "text",
  "jobId": "text",
  "groups": [
    {
      "id": "text",
      "message": {
        "id": "text",
        "signature": "text",
        "invitation": "text",
        "domain": "text",
        "delivered": true,
        "requestId": "text",
        "cdate": 1,
        "vdate": 1,
        "tvdate": 1,
        "tauthor": "text",
        "referrer": "text",
        "status": "text",
        "executedOn": "text",
        "timestamp": 1,
        "jobId": "text",
        "logs": [
          {}
        ],
        "content": {
          "from": "text",
          "fromname": "text",
          "to": "text",
          "replyTo": "text",
          "subject": "text",
          "text": "text",
          "sendAt": 1
        }
      },
      "jobId": "text",
      "status": "text",
      "messages": []
    }
  ]
}

message response

Find messages by different filters

get

/messages/requests

Authorizations

Query parameters

idstring · min: 1

Message id.

jobIdstring · min: 1

Job id used to send Messages.

invitationstring · min: 1

Message invitation.

domainstring · min: 1

Message domain.

subjectstring · min: 1

Subject of the Message.

parentGroupstring · min: 1

Parent Group the recipients belongs to.

tauthorstring · min: 1

Email of the author of the message.

limitinteger

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

cacheboolean

Get result from cache. Without the right privileges this parameter will be ignored.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/messages/requests'

200

default

200

{
  "count": 1,
  "requests": []
}

message response

Create a direct message

post

/messages/requests

Authorizations

Body

signaturestring · min: 1

Signature of the message.

fromNamestring

Name of the sender.

fromEmailstring

Email of the sender.

subjectstringrequired

Subject of the message.

messagestringrequired

Message body.

parentGroupstring | nullable

Parent group that the groups belong to.

invitationstringrequired

Invitation used to validate message

sendAtinteger | nullable

Send the message at a specific UTC time in milliseconds in the future. Maximum is 70 hours.

replyTostring | nullable

Email address the recipient should replyto.

useJobboolean | nullable

Whether to wait for messages to be sent.

groupsstring · min: 1[]required

Groups the message is sent to.

ignoreGroupsstring · min: 1[] · default: | nullable

Groups the message should not be sent to.

fromobject | nullable

Email address the message is sent from.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/messages/requests' \
  --header 'Content-Type: application/json' \
  --data '{"subject":"text","message":"text","invitation":"text","groups":[null],"ignoreGroups":[],"from":{}}'

200

default

200

{
  "id": "text",
  "signature": "text",
  "invitation": "text",
  "domain": "text",
  "replyTo": "text",
  "useJob": true,
  "jobId": "text",
  "parentGroup": "text",
  "sendAt": 1,
  "subject": "text",
  "message": "text",
  "fromEmail": "text",
  "fromName": "text",
  "tauthor": "text",
  "groups": [
    "text"
  ],
  "ignoreGroups": [
    "text"
  ]
}

message response

Mark a message as viewed

post

/messages/viewed

Authorizations

Body

vdateinteger | nullablerequired

Viewed date in milliseconds.

idsstring · min: 1[]required

Message ids to mark as viewed.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api2.openreview.net/messages/viewed' \
  --header 'Content-Type: application/json'

200

default

200

{
  "status": "text"
}

Mark as viewed response

Get logs by different filters

get

/logs/process

Authorizations

Query parameters

idstring · min: 1

log id

parentGroupstring · min: 1

Parent Group id

invitationstring · min: 1

Invitation id that contains the process function.

statusstring · min: 1

Status of the process. It can be ok or error.

minsdateinteger

Minimum start date in milliseconds.

limitinteger · default: 1000

Maximum number of results to return.

offsetinteger

Offset of the result shown.

afterstring · min: 1

Return documents that come after the after parameter. After should be an id.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api2.openreview.net/logs/process'

200

default

200

{
  "count": 1,
  "logs": []
}

log response