Calls for papers

The call_for_papers object

A call for papers of an event: the window in which authors submit their papers, and the themes they submit them to.

Attributes

idstring

Unique identifier for the object: the call's reference on the platform.

objectenum

String representing the object's type. Always call_for_papers.

Possible values

call_for_papers

eventstring or expanded event objectexpandable

The event of the call: its id, or the event object when it is expanded (expand[]=event, or expand[]=data.event in a list; needs events_read).

titlestring

The call's title.

statusenum

The call's status (the same values as an event's). A client must accept a value it does not know: adding a value is a compatible change.

Possible values

draft
scheduled
opened
suspended
reported
closed
canceled

typeenumnullable

The kind of papers the call collects; null when it has none. A client must accept a value it does not know.

Possible values

academic_conferences
journals_and_periodicals
special_issues
workshops_and_symposium
research_competitions
theses_and_dissertations
grant_proposals
book_chapters
call_for_abstracts
panel_proposals

submissions_open_attimestampnullable

When submissions open, in Unix seconds (UTC); null when it is not set.

submissions_close_attimestampnullable

When submissions close, in Unix seconds (UTC); null when it is not set.

themesarray of object

The call's themes, sorted by name; [] when it has none.

Child attributes

namestringnullable: The theme's name.
descriptionstringnullable: What the theme covers; null when it is not described.

createdtimestamp

Time at which the object was created, in Unix seconds (UTC).

updatedtimestampnullable

Time at which the object was last modified, in Unix seconds (UTC); null when the platform holds none.

Example object

{
  "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
  "object": "call_for_papers",
  "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
  "title": "Call for papers 2027",
  "status": "opened",
  "type": "academic_conferences",
  "submissions_open_at": 1788217200,
  "submissions_close_at": 1798761600,
  "themes": [
    {
      "name": "Energy storage",
      "description": "Batteries, hydrogen and thermal storage at every scale."
    },
    {
      "name": "Solar power",
      "description": null
    }
  ],
  "created": 1785625200,
  "updated": 1788217200
}

Retrieve a call for papers

GET/v1/calls_for_papers/{id}

Retrieves the call for papers with this id, with its submission window and its themes sorted by name. expand[]=event gives the event object in place of its id (the key also needs events_read). Needs the calls for papers module in your organization's plan. A call of another organization answers resource_missing, like an id that does not exist.

Requires the scope calls_for_papers_read.

Path parameters

idstringrequired: The id of the call for papers.

Query parameters

expand[]array of enumoptional: event: the event object in place of its id (needs events_read).
Possible values
event

Returns

Returns the call_for_papers object.

Error codes

Request

curl

curl -G https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83 \
  -H "Authorization: Bearer mcf_your_key"

JavaScript

const res = await fetch("https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83", {
  headers: { Authorization: "Bearer mcf_your_key" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
    headers={"Authorization": "Bearer mcf_your_key"},
)
data = res.json()

Response

{
  "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
  "object": "call_for_papers",
  "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
  "title": "Call for papers 2027",
  "status": "opened",
  "type": "academic_conferences",
  "submissions_open_at": 1788217200,
  "submissions_close_at": 1798761600,
  "themes": [
    {
      "name": "Energy storage",
      "description": "Batteries, hydrogen and thermal storage at every scale."
    },
    {
      "name": "Solar power",
      "description": null
    }
  ],
  "created": 1785625200,
  "updated": 1788217200
}

List calls for papers

GET/v1/calls_for_papers

Returns a page of your organization's calls for papers, or of one event's with event, newest first (created descending, then id descending). Walk the pages with starting_after (or ending_before). Needs the calls for papers module in your organization's plan. An event of another organization answers resource_missing on event.

Requires the scope calls_for_papers_read.

Query parameters

eventstringoptional: Only the calls of this event (its id).
statusarray of enumoptional: Only the calls in this status. Repeat the parameter for several (status=opened&status=scheduled).
Possible values
draft
scheduled
opened
suspended
reported
closed
canceled
limitintegeroptional: The number of objects of the page, from 1 to 100; at most 20 when the request has an expand[] (each expanded or included field costs reads per object of the page).
Defaults to 10.
starting_afterstringoptional: A cursor for the next page: the id of an object of this list (the last one of the page you have); the page holds the objects that follow it. Not with ending_before.
ending_beforestringoptional: A cursor for the previous page: the id of an object of this list (the first one of the page you have); the page holds the objects that precede it, in the same order. Not with starting_after.
include[]array of enumoptional: total_count: add total_count, the number of objects of the whole list.
Possible values
total_count
expand[]array of enumoptional: data.event: the event object in place of its id in each call (needs events_read).
Possible values
data.event

Returns

Returns a list object whose data are call_for_papers objects.

Error codes

Request

curl

curl -G https://api.masterconf.com/v1/calls_for_papers \
  -H "Authorization: Bearer mcf_your_key"

JavaScript

const res = await fetch("https://api.masterconf.com/v1/calls_for_papers", {
  headers: { Authorization: "Bearer mcf_your_key" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.masterconf.com/v1/calls_for_papers",
    headers={"Authorization": "Bearer mcf_your_key"},
)
data = res.json()

Response

{
  "object": "list",
  "url": "/v1/calls_for_papers",
  "has_more": true,
  "data": [
    {
      "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
      "object": "call_for_papers",
      "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
      "title": "Call for papers 2027",
      "status": "opened",
      "type": "academic_conferences",
      "submissions_open_at": 1788217200,
      "submissions_close_at": 1798761600,
      "themes": [
        {
          "name": "Energy storage",
          "description": "Batteries, hydrogen and thermal storage at every scale."
        },
        {
          "name": "Solar power",
          "description": null
        }
      ],
      "created": 1785625200,
      "updated": 1788217200
    }
  ]
}