Submittable API Client Module¶
The following documentation is generated from the Submittable API Client module.
Submittable API Client¶
This module is designed to provide easy Python access to the API provided by https://submittable.com. Additional information about this API can be found at https://apidoc.submittable.com.
Requires existence of Python requests module: http://docs.python-requests.org/
-
class
submittable_api_client.
SubmittableAPIClient
(username=None, apitoken=None, per_page=20)¶ The primary class instantiated to make an API call.
Parameters: - username (str) – Submittable.com username
- apitoken (str) – Submittable.com API token
- per_page (int) – Per page item limit (defaults to 20)
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.-
categories
()¶ Returns a list of Categories. Allows no pagination.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
category
(cat_id=None)¶ Returns information about a single Category.
Parameters: cat_id (int) – ID of Category Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
category_form
(cat_id=None)¶ Returns the form info associated with the Category.
Parameters: cat_id (int) – ID of Category Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
category_submitters
(cat_id=None, page=None, per_page=None)¶ Returns user records that have submitted this form.
Parameters: - cat_id (int) – ID of Category
- page (int) – Page number to start on.
- per_page (int) – Number of items per page to return.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
payments
(year=None, month=None)¶ Returns Assignments attached to a single Submission.
Parameters: - year (int) – Year (YYYY) value to filter against.
- month (int) – Numeric month (MM) value to filter against.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submission
(sub_id=None)¶ Returns information about a single Submission.
Parameters: sub_id (int) – ID of Submission object to retrieve. Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submission_assignments
(sub_id=None)¶ Returns Assignments attached to a single Submission.
Parameters: sub_id (int) – ID of Submission object to retrieve. Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata
-
submission_file
(sub_id=None, file_guid=None)¶ Returns a File attached to a single Submission.
Parameters: - sub_id (int) – ID of Submission object to retrieve.
- file_guid (str) – GUID for File object attached to Submission object.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submission_form
(sub_id=None)¶ Returns Form attached to a single Submission.
Parameters: sub_id (int) – ID of Submission object to retrieve. Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submission_history
(sub_id=None)¶ Returns history for a single Submission.
Parameters: sub_id (int) – ID of Submission object to retrieve. Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submission_labels
(sub_id=None)¶ Returns labels for a single Submission.
Parameters: sub_id (int) – ID of Submission object to retrieve. Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submissions
(sort='submitted', direction='desc', page=1, per_page=20, status='inprogress')¶ Returns a list of Submissions. Allows pagination, sorting and filters.
Parameters: - sort (str) – Keyword for attribute to sort against.
- direction (str) – Keyword for direction of sort (asc or desc).
- page (int) – Page number to start on.
- per_page (int) – Number of items per page to return.
- status (str) – Keyword for Status value to filter against.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
-
submitters
(page=1, per_page=20)¶ Returns Submitters for an Organization.
Parameters: - page (int) – Page number to start on.
- per_page (int) – Number of items per page to return.
Returns: SubmittableAPIResponse
containing a list of content-specific objects and related metadata.
Submittable API Client Response¶
-
class
submittable_api_client.
SubmittableAPIResponse
(response=None, obj_type=None)¶ The response object from the Submittable API. Expects reponse from requests module.
Parameters: - response (obj) – Response object from
requests
module. - obj_type (str) – String keyword for type of object being requested.
Returns: None
-
provision_categories
()¶ Build Category-specific metadata and item objects.
-
provision_category
()¶ Build Category-specific metadata and item objects.
-
provision_category_form
()¶ Build category form objects.
-
provision_category_submitters
()¶ Build category form objects.
-
provision_payments
()¶ Build Payment-specific metadata and item objects.
-
provision_submission
()¶ Build Submission-specific metadata and item objects.
-
provision_submission_assignments
()¶ Build Assignment-specific metadata and item objects.
-
provision_submission_form
()¶ Build submitted form-specific metadata and item objects.
-
provision_submission_history
()¶ Build submission history metadata and item objects.
-
provision_submission_labels
()¶ Build submission label metadata and item objects.
-
provision_submissions
()¶ Build submission listing metadata and item objects.
-
provision_submitters
()¶ Build Submitter-specific metadata and item objects.
- response (obj) – Response object from
Item Objects¶
-
class
submittable_api_client.
Category
(data)¶ Item object container for Categories.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
SubmittedFormContainer
(data)¶ Representation of the Submitted Form container as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
SubmissionHistory
(data)¶ Representation of Submission History as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
LabelsContainer
(data)¶ Representation of Labels Container as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
SubmissionLabel
(data)¶ Representation of Submission Label as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
Votes
(data)¶ Representation of Votes data as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
File
(data)¶ Representation of files container as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
Submission
(data)¶ Representation of Submission as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
Payment
(data)¶ Representation of Payment as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
SubmittedFormField
(data)¶ Item container for a submitted form.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
Submitter
(data)¶ Item object container for Submitters.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
AssignmentsContainer
(data)¶ Representation of Assignments Container as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
Assignment
(data)¶ Representation of Assignment as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
FormFieldContainer
(data)¶ Representation of the formfields dictionary as a Python object.
Parameters: data (str) – Data dictionary in JSON format.
-
class
submittable_api_client.
FormFieldItem
(data)¶ Representation of a formfield as a Python object.
Parameters: data (str) – Data dictionary in JSON format.