Get all attachments for a permit

get

/fscmRestApi/resources/11.13.18.05/publicSectorRecordAttachments

Request

Query Parameters
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • Used as a predefined finder to search the collection.

    Format: ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables:

    • AltKey: The public unique identifier for a permit attachment.
      Finder Variables:
      • LnpAttachmentPuid; string.
    • PrimaryKey: Finds the record attachment that matches the primary key criteria specified.
      Finder Variables:
      • AttachmentId; integer.
      • LnpAttachmentKey; integer; The unique identifier of the permit attachment.
    • simpleSearchFinder: Finds the permit attachment that matches the search criteria specified.
      Finder Variables:
      • attachmentIdValue; integer; The search value used to find a record attachment for a given attachment ID.
      • attachmentKeyValue; integer; The search value used to find a record attachment for a given attachment key.
      • docCategory; string; The search value used to find a record attachment for a given category.
      • docSubcategory; string; The search value used to find a record attachment for a given subcategory.
      • fileTypeValue; string; The search value used to find a record attachment for a given file type.
      • lnpRecordKeyValue; integer; The search value used to find a record attachment for a given record key.
      • value; string; The search value used to find a specific record attachment.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AcceptedEventFlag; boolean; Indicates whether the attachment record meets the required documents document category and subcategory requirements for the acceptance application step. The default value is no.
    • AgencyId; integer; The agency identifier of the public sector entity to which this attachment applies.
    • AttachmentEntityName; string; The entity name of the attachment.
    • AttachmentId; integer; The unique identifier for a permit attachment.
    • AttachmentType; string; The type of attachment, such as for plan reviews, inspections, or permits.
    • CompletedEventFlag; boolean; Indicates whether the attachment record meets the required documents document category and subcategory requirements for the complete application step. The default value is no.
    • ConfidentialFlag; boolean; Indicates whether the attachment is a confidential document. The default value is N for no.
    • CreatedByName; string; The user who created the attachment.
    • CreationDate; string; The date and time when the attachment was created.
    • Description; string; The description of the attachment.
    • DigitalSignatureFlag; boolean; Indicates whether the attachment requires a digital signature. If the value is Y, then a digital signature is required. The default value is N.
    • DocumentCategory; string; The category used for dividing the attached document into a logical group.
    • DocumentGroupId; string; The document group specified on the permit type when the attachment was uploaded.
    • DocumentReviewedFlag; boolean; Indicates whether the attachment was reviewed and returned by the electronic document review application. The default value is N.
    • DocumentSubcategory; string; The subcategory used for dividing the attached document into a logical group along with the category.
    • FileName; string; The name of the attached file.
    • FileSize; integer; The size of the attached file.
    • FileType; string; The file type of attachment, such as PDF or text.
    • FinalDocumentFlag; boolean; Indicates whether the attachment is the final document for a permit, business license, or planning application. The default value is N for no.
    • FinalInspectionEventFlag; boolean; Indicates whether the attachment record meets the required documents document category and subcategory requirements for the final inspection application step. The default value is no.
    • IssuedEventFlag; boolean; Indicates whether the attachment record meets the required documents document category and subcategory requirements for the issuance application step. The default value is no.
    • LastUpdateDate; string; The date and time when the attachment was last updated.
    • LnpAttachmentKey; integer; The unique key associated with the permit attachment.
    • LnpAttachmentPuid; string; The public unique identifier for a permit attachment.
    • LnpRecordKey; integer; The unique identifier for a record. The record is for a permit, business license, professional license, or planning and zoning, and is determined by the classification.
    • PlanReviewFlag; boolean; Indicates whether the attachment is associated with a plan review. If the value is Y, then the attachment is associated with a plan review. The default value is N.
    • PreviewHeight; number; This column indicates the height of a stored thumbnail.
    • PreviewWidth; number; This column indicates the width of a stored thumbnail.
    • ProtectionLevel; string; Indicates whether the attachment has some level of protection and what type of protection. The default value is N for None.
    • RecordAgencyId; integer; The agency identifier of the public sector entity to which this attachment applies.
    • RecordAttachmentId; integer; The unique identifier for an attachment.
    • RecordNumber; string; The public unique identifier for a permit record.
    • RequiredFlag; boolean; Indicates whether the attachment is a required document. The default value is N for no.
    • RevisedDocUploadedFlag; boolean; Indicates whether the attachment was uploaded during a rejected or approved plan review cycle. Default value is N for no.
    • SubjectId; string; The subject of the attachment.
    • SubmittedEventFlag; boolean; Indicates whether the attachment record meets the required documents document category and subcategory requirements for the submittal application step. The default value is no.
    • UpdatedByName; string; The user who last updated the attachment.
    • Version; integer; The version of the attachment.
    • WriteProtectedFlag; boolean; Indicates whether the attachment is write-protected. The default value is N for no.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : publicSectorRecordAttachments
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : publicSectorRecordAttachments-item-response
Type: object
Show Source
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the acceptance application step. The default value is no.
  • Title: Agency ID
    Default Value: 1
    The agency identifier of the public sector entity to which this attachment applies.
  • Maximum Length: 255
    Default Value: PSC_DOC_LNP
    The entity name of the attachment.
  • The unique identifier for a permit attachment.
  • Maximum Length: 15
    Default Value: LNP
    The type of attachment, such as for plan reviews, inspections, or permits.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the complete application step. The default value is no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is a confidential document. The default value is N for no.
  • Indicates that the attachment is being created as a copy from an existing attachment. The default value is N for No.
  • Title: Uploaded By
    The user who created the attachment.
  • Title: Uploaded On
    Read Only: true
    The date and time when the attachment was created.
  • Title: Description
    Maximum Length: 100
    The description of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment requires a digital signature. If the value is Y, then a digital signature is required. The default value is N.
  • Title: Category
    Maximum Length: 30
    The category used for dividing the attached document into a logical group.
  • Maximum Length: 30
    The document group specified on the permit type when the attachment was uploaded.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment was reviewed and returned by the electronic document review application. The default value is N.
  • Title: Subcategory
    Maximum Length: 30
    The subcategory used for dividing the attached document into a logical group along with the category.
  • Title: File Name
    Maximum Length: 255
    The name of the attached file.
  • Title: File Size
    The size of the attached file.
  • Maximum Length: 100
    The file type of attachment, such as PDF or text.
  • Title: Final
    Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is the final document for a permit, business license, or planning application. The default value is N for no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the final inspection application step. The default value is no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the issuance application step. The default value is no.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the attachment was last updated.
  • Links
  • Record Attachment Accessors
    Title: Record Attachment Accessors
    The record attachment accessors resource is used for displaying permit attachment file-related information such as file name and file URL.
  • The unique key associated with the permit attachment.
  • Maximum Length: 480
    The public unique identifier for a permit attachment.
  • The unique identifier for a record. The record is for a permit, business license, professional license, or planning and zoning, and is determined by the classification.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is associated with a plan review. If the value is Y, then the attachment is associated with a plan review. The default value is N.
  • This column contains the thumbnail of an attached file.
  • This column indicates the height of a stored thumbnail.
  • This column indicates the width of a stored thumbnail.
  • Maximum Length: 1
    Default Value: N
    Indicates whether the attachment has some level of protection and what type of protection. The default value is N for None.
  • The agency identifier of the public sector entity to which this attachment applies.
  • The unique identifier for an attachment.
  • Maximum Length: 64
    The public unique identifier for a permit record.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is a required document. The default value is N for no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment was uploaded during a rejected or approved plan review cycle. Default value is N for no.
  • The unique identifier of the source attachment, if the attachment is being created as a copy.
  • The attachment type of the source attachment, if the attachment is being created as a copy.
  • Maximum Length: 30
    The subject of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the submittal application step. The default value is no.
  • Title: Last Updated By
    The user who last updated the attachment.
  • The version of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is write-protected. The default value is N for no.
Nested Schema : Record Attachment Accessors
Type: array
Title: Record Attachment Accessors
The record attachment accessors resource is used for displaying permit attachment file-related information such as file name and file URL.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-item-response
Type: object
Show Source
Nested Schema : Record Attachment Revisions
Type: array
Title: Record Attachment Revisions
The record attachments revisions resource is used for displaying the historical information for a permit attachment.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-AttachmentsRevision-item-response
Type: object
Show Source
Back to Top