# Query the filing calendar setup model Source: https://developer.avalara.com/products/returns/integration-guides/managed-returns/crw7774888032032/ Guide: Avalara Managed Returns API (U.S. and Canada) # Query the filing calendar setup model Learn how to use the `filingCalendarRequests` GraphQL query to retrieve the setup model for a specific return form. Use the `filingCalendarRequests` GraphQL query to retrieve the setup model for a specific return form. This model provides: - Supported filing frequencies (for example, monthly, quarterly). - Filing methods (for example, electronic). - Required onboarding questions (for example, EIN, registration ID, business address). **View request**: ``` query FilingCalendarRequests { filingCalendarRequests( input: { companyId: 123456, taxFormCode: "USAZTPT2" } ) { value { filingCalendarRequestModel { id companyId filingRequestStatusId data { companyReturnId country effDate endDate filingFrequencyId fiscalYearStartMonth isClone locationCode region registrationId taxAuthorityId taxAuthorityName taxFormCode taxTypeId canValidateEfileCredentials isTwoFactorAuthRequired twoFactorAlias twoFactorAuthForwardEmail answers { answer filingQuestionId filingQuestionCode } filingMethods { filingMethod filingMethodId } questions { dataType destination filingQuestionId filingQuestionCode helpText question regex required sortOrder } formFilingFrequencies { code filingFrequency filingFrequencyId legacyFilingFrequencyId frequencyTrigger startDay endDay filingPeriodDates { description filingDueDate transactionalPeriodEnd transactionalPeriodStart } } } } } } } ``` **View response**: ``` { "data": { "filingCalendarRequests": { "value": { "filingCalendarRequestModel": { "id": null, "companyId": 123456, "filingRequestStatusId": "NEW", "data": { "companyReturnId": null, "country": "US", "effDate": "2025-04-01T00:00:00", "endDate": null, "filingFrequencyId": "MONTHLY", "fiscalYearStartMonth": null, "isClone": false, "locationCode": null, "region": "AZ", "registrationId": "", "taxAuthorityId": null, "taxAuthorityName": "ARIZONA", "taxFormCode": "USAZTPT2", "taxTypeId": null, "canValidateEfileCredentials": true, "isTwoFactorAuthRequired": true, "twoFactorAlias": "test2FA", "twoFactorAuthForwardEmail": "abc@test.com", "answers": [ { "answer": "1", "filingQuestionId": 2, "filingQuestionCode": null }, { "answer": "CRR-22125-HR11-1", "filingQuestionId": 24, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 26, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 27, "filingQuestionCode": null }, { "answer": "126 River Forest Dr", "filingQuestionId": 28, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 29, "filingQuestionCode": null }, { "answer": "Littleton", "filingQuestionId": 30, "filingQuestionCode": null }, { "answer": "NC", "filingQuestionId": 31, "filingQuestionCode": null }, { "answer": "27859", "filingQuestionId": 32, "filingQuestionCode": null }, { "answer": "US", "filingQuestionId": 33, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 34, "filingQuestionCode": null }, { "answer": "123456789", "filingQuestionId": 36, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 111, "filingQuestionCode": null }, { "answer": "", "filingQuestionId": 113, "filingQuestionCode": null }, { "answer": "false", "filingQuestionId": 251, "filingQuestionCode": null } ], "filingMethods": [ { "filingMethod": "Electronic", "filingMethodId": 2 } ], "questions": [ { "dataType": "INTEGER", "destination": "FilingTypeId", "filingQuestionId": 2, "filingQuestionCode": "FilingMethod", "helpText": "", "question": "Filing Method", "regex": "", "required": true, "sortOrder": 2 }, { "dataType": "STRING", "destination": "LegalEntityName", "filingQuestionId": 24, "filingQuestionCode": "LegalEntityName", "helpText": "", "question": "Legal Entity Name", "regex": "", "required": true, "sortOrder": 3 }, { "dataType": "STRING", "destination": "EfileUsername", "filingQuestionId": 26, "filingQuestionCode": "EfileUsername", "helpText": "", "question": "Efile Username", "regex": "", "required": true, "sortOrder": 4 }, { "dataType": "STRING", "destination": "EfilePassword", "filingQuestionId": 27, "filingQuestionCode": "EfilePassword", "helpText": "", "question": "Efile Password", "regex": "", "required": true, "sortOrder": 5 }, { "dataType": "STRING", "destination": "Line1", "filingQuestionId": 28, "filingQuestionCode": "AddressLine1", "helpText": "", "question": "Address Line 1", "regex": "", "required": true, "sortOrder": 6 }, { "dataType": "STRING", "destination": "Line2", "filingQuestionId": 29, "filingQuestionCode": "AddressLine2", "helpText": "", "question": "Address Line 2", "regex": "", "required": false, "sortOrder": 7 }, { "dataType": "STRING", "destination": "City", "filingQuestionId": 30, "filingQuestionCode": "City", "helpText": "", "question": "City", "regex": "", "required": true, "sortOrder": 8 }, { "dataType": "STRING", "destination": "Region", "filingQuestionId": 31, "filingQuestionCode": "Region", "helpText": "", "question": "Region", "regex": "", "required": true, "sortOrder": 9 }, { "dataType": "STRING", "destination": "PostalCode", "filingQuestionId": 32, "filingQuestionCode": "ZipCode", "helpText": "", "question": "Zip Code", "regex": "", "required": true, "sortOrder": 10 }, { "dataType": "STRING", "destination": "Country", "filingQuestionId": 33, "filingQuestionCode": "Country", "helpText": "", "question": "Country", "regex": "", "required": true, "sortOrder": 11 }, { "dataType": "STRING", "destination": "Phone", "filingQuestionId": 34, "filingQuestionCode": "Phone", "helpText": "", "question": "Phone", "regex": "", "required": true, "sortOrder": 12 }, { "dataType": "STRING", "destination": "Ein", "filingQuestionId": 36, "filingQuestionCode": "EIN", "helpText": "A taxpayer ID or Employer Identification Number (EIN) is a unique identifier the IRS gives to U.S. companies for tax reporting. This number is nine digits in length. The first two digits are alpha-numeric. You may include or exclude the dash when entering your EIN in this field. \nExamples: \n12-3456789 or TF-3456789 \n123456789 or TF3456789 \n ", "question": "Taxpayer ID or Employer Identification Number (EIN)", "regex": "^[a-zA-Z0-9]{2}-?(?!(\\d)\\1{6,})[\\d]{7}__PRE_BLOCK_1__quot;, "required": true, "sortOrder": 13 }, { "dataType": "STRING", "destination": "RegistrationId", "filingQuestionId": 51, "filingQuestionCode": "ArizonaStateLicenseNumber", "helpText": "Find your state license number on your Arizona sales tax permit, or online on the Arizona e-filing website. \nExample license number: 12345678", "question": "Arizona State License Number", "regex": "\\d\\d\\d\\d\\d\\d\\d\\d", "required": true, "sortOrder": 1 }, { "dataType": "STRING", "destination": "Settings", "filingQuestionId": 111, "filingQuestionCode": "AZOOSloc", "helpText": "Your three-digit Arizona out-of-state location ID is used to track transactions where they do not originate in Arizona, such as online purchases. Find your out-of-state location ID by checking the location registration online. Not all businesses have an OOS registered location. This is not the same as business code reporting requirements.", "question": "What is your Arizona Out of State Location ID?", "regex": "^((?!000|017|029|605)\\d{3})__PRE_BLOCK_1__quot;, "required": false, "sortOrder": 2 }, { "dataType": "STRING", "destination": "Settings", "filingQuestionId": 113, "filingQuestionCode": "AZPin", "helpText": "Enter the 6-10 digit esigniture PIN that you created when setting up your username and online account. If you are unsure of your current Epin, you will need to reset it via your AZ account or by contacting the State.", "question": "What is your Arizona PIN?", "regex": "^\\d{6}\\d?\\d?\\d?\\d?__PRE_BLOCK_1__quot;, "required": true, "sortOrder": 3 }, { "dataType": "BOOLEAN", "destination": "Settings", "filingQuestionId": 251, "filingQuestionCode": "AZRemoteSeller", "helpText": "Arizona remote sellers are required to collect and remit tax. Select \"Yes\" if you are registered with the state of Arizona as a remote seller.", "question": "Are you registered as a Remote Seller in Arizona?", "regex": "", "required": true, "sortOrder": 6 } ], "formFilingFrequencies": [ { "code": "M", "filingFrequency": "Monthly", "filingFrequencyId": 3, "legacyFilingFrequencyId": 1, "frequencyTrigger": "More than $8,000 estimated annual combined Arizona, county and municipal tax liability", "startDay": 0, "endDay": 0, "filingPeriodDates": [ { "description": "Monthly filing for April 2025, due May 20 2025.", "filingDueDate": "2025-05-20T00:00:00", "transactionalPeriodEnd": "2025-04-30T00:00:00", "transactionalPeriodStart": "2025-04-01T00:00:00" }, { "description": "Monthly filing for May 2025, due June 20 2025.", "filingDueDate": "2025-06-20T00:00:00", "transactionalPeriodEnd": "2025-05-31T00:00:00", "transactionalPeriodStart": "2025-05-01T00:00:00" }, { "description": "Monthly filing for June 2025, due July 20 2025.", "filingDueDate": "2025-07-20T00:00:00", "transactionalPeriodEnd": "2025-06-30T00:00:00", "transactionalPeriodStart": "2025-06-01T00:00:00" }, { "description": "Monthly filing for July 2025, due August 20 2025.", "filingDueDate": "2025-08-20T00:00:00", "transactionalPeriodEnd": "2025-07-31T00:00:00", "transactionalPeriodStart": "2025-07-01T00:00:00" }, { "description": "Monthly filing for August 2025, due September 20 2025.", "filingDueDate": "2025-09-20T00:00:00", "transactionalPeriodEnd": "2025-08-31T00:00:00", "transactionalPeriodStart": "2025-08-01T00:00:00" }, { "description": "Monthly filing for September 2025, due October 20 2025.", "filingDueDate": "2025-10-20T00:00:00", "transactionalPeriodEnd": "2025-09-30T00:00:00", "transactionalPeriodStart": "2025-09-01T00:00:00" }, { "description": "Monthly filing for October 2025, due November 20 2025.", "filingDueDate": "2025-11-20T00:00:00", "transactionalPeriodEnd": "2025-10-31T00:00:00", "transactionalPeriodStart": "2025-10-01T00:00:00" }, { "description": "Monthly filing for November 2025, due December 20 2025.", "filingDueDate": "2025-12-20T00:00:00", "transactionalPeriodEnd": "2025-11-30T00:00:00", "transactionalPeriodStart": "2025-11-01T00:00:00" }, { "description": "Monthly filing for December 2025, due January 20 2026.", "filingDueDate": "2026-01-20T00:00:00", "transactionalPeriodEnd": "2025-12-31T00:00:00", "transactionalPeriodStart": "2025-12-01T00:00:00" }, { "description": "Monthly filing for January 2026, due February 20 2026.", "filingDueDate": "2026-02-20T00:00:00", "transactionalPeriodEnd": "2026-01-31T00:00:00", "transactionalPeriodStart": "2026-01-01T00:00:00" }, { "description": "Monthly filing for February 2026, due March 20 2026.", "filingDueDate": "2026-03-20T00:00:00", "transactionalPeriodEnd": "2026-02-28T00:00:00", "transactionalPeriodStart": "2026-02-01T00:00:00" }, { "description": "Monthly filing for March 2026, due April 20 2026.", "filingDueDate": "2026-04-20T00:00:00", "transactionalPeriodEnd": "2026-03-31T00:00:00", "transactionalPeriodStart": "2026-03-01T00:00:00" }, { "description": "Monthly filing for April 2026, due May 20 2026.", "filingDueDate": "2026-05-20T00:00:00", "transactionalPeriodEnd": "2026-04-30T00:00:00", "transactionalPeriodStart": "2026-04-01T00:00:00" }, { "description": "Monthly filing for May 2026, due June 20 2026.", "filingDueDate": "2026-06-20T00:00:00", "transactionalPeriodEnd": "2026-05-31T00:00:00", "transactionalPeriodStart": "2026-05-01T00:00:00" }, { "description": "Monthly filing for June 2026, due July 20 2026.", "filingDueDate": "2026-07-20T00:00:00", "transactionalPeriodEnd": "2026-06-30T00:00:00", "transactionalPeriodStart": "2026-06-01T00:00:00" }, { "description": "Monthly filing for July 2026, due August 20 2026.", "filingDueDate": "2026-08-20T00:00:00", "transactionalPeriodEnd": "2026-07-31T00:00:00", "transactionalPeriodStart": "2026-07-01T00:00:00" }, { "description": "Monthly filing for August 2026, due September 20 2026.", "filingDueDate": "2026-09-20T00:00:00", "transactionalPeriodEnd": "2026-08-31T00:00:00", "transactionalPeriodStart": "2026-08-01T00:00:00" }, { "description": "Monthly filing for September 2026, due October 20 2026.", "filingDueDate": "2026-10-20T00:00:00", "transactionalPeriodEnd": "2026-09-30T00:00:00", "transactionalPeriodStart": "2026-09-01T00:00:00" }, { "description": "Monthly filing for October 2026, due November 20 2026.", "filingDueDate": "2026-11-20T00:00:00", "transactionalPeriodEnd": "2026-10-31T00:00:00", "transactionalPeriodStart": "2026-10-01T00:00:00" }, { "description": "Monthly filing for November 2026, due December 20 2026.", "filingDueDate": "2026-12-20T00:00:00", "transactionalPeriodEnd": "2026-11-30T00:00:00", "transactionalPeriodStart": "2026-11-01T00:00:00" }, { "description": "Monthly filing for December 2026, due January 20 2027.", "filingDueDate": "2027-01-20T00:00:00", "transactionalPeriodEnd": "2026-12-31T00:00:00", "transactionalPeriodStart": "2026-12-01T00:00:00" }, { "description": "Monthly filing for January 2027, due February 20 2027.", "filingDueDate": "2027-02-20T00:00:00", "transactionalPeriodEnd": "2027-01-31T00:00:00", "transactionalPeriodStart": "2027-01-01T00:00:00" }, { "description": "Monthly filing for February 2027, due March 20 2027.", "filingDueDate": "2027-03-20T00:00:00", "transactionalPeriodEnd": "2027-02-28T00:00:00", "transactionalPeriodStart": "2027-02-01T00:00:00" }, { "description": "Monthly filing for March 2027, due April 20 2027.", "filingDueDate": "2027-04-20T00:00:00", "transactionalPeriodEnd": "2027-03-31T00:00:00", "transactionalPeriodStart": "2027-03-01T00:00:00" } ] }, { "code": "Q", "filingFrequency": "Quarterly", "filingFrequencyId": 6, "legacyFilingFrequencyId": 2, "frequencyTrigger": "$2,000 - $8,000 estimated annual combined Arizona, county and municipal tax liability", "startDay": 0, "endDay": 0, "filingPeriodDates": [ { "description": "Quarterly filing for April 2025, due July 20 2025.", "filingDueDate": "2025-07-20T00:00:00", "transactionalPeriodEnd": "2025-06-30T00:00:00", "transactionalPeriodStart": "2025-04-01T00:00:00" }, { "description": "Quarterly filing for July 2025, due October 20 2025.", "filingDueDate": "2025-10-20T00:00:00", "transactionalPeriodEnd": "2025-09-30T00:00:00", "transactionalPeriodStart": "2025-07-01T00:00:00" }, { "description": "Quarterly filing for October 2025, due January 20 2026.", "filingDueDate": "2026-01-20T00:00:00", "transactionalPeriodEnd": "2025-12-31T00:00:00", "transactionalPeriodStart": "2025-10-01T00:00:00" }, { "description": "Quarterly filing for January 2026, due April 20 2026.", "filingDueDate": "2026-04-20T00:00:00", "transactionalPeriodEnd": "2026-03-31T00:00:00", "transactionalPeriodStart": "2026-01-01T00:00:00" }, { "description": "Quarterly filing for April 2026, due July 20 2026.", "filingDueDate": "2026-07-20T00:00:00", "transactionalPeriodEnd": "2026-06-30T00:00:00", "transactionalPeriodStart": "2026-04-01T00:00:00" }, { "description": "Quarterly filing for July 2026, due October 20 2026.", "filingDueDate": "2026-10-20T00:00:00", "transactionalPeriodEnd": "2026-09-30T00:00:00", "transactionalPeriodStart": "2026-07-01T00:00:00" }, { "description": "Quarterly filing for October 2026, due January 20 2027.", "filingDueDate": "2027-01-20T00:00:00", "transactionalPeriodEnd": "2026-12-31T00:00:00", "transactionalPeriodStart": "2026-10-01T00:00:00" }, { "description": "Quarterly filing for January 2027, due April 20 2027.", "filingDueDate": "2027-04-20T00:00:00", "transactionalPeriodEnd": "2027-03-31T00:00:00", "transactionalPeriodStart": "2027-01-01T00:00:00" } ] }, { "code": "A", "filingFrequency": "Annually", "filingFrequencyId": 9, "legacyFilingFrequencyId": 4, "frequencyTrigger": "Less than $2,000 estimated annual combined Arizona, county and municipal tax liability", "startDay": 0, "endDay": 0, "filingPeriodDates": [ { "description": "Annually filing for January 2025, due January 20 2026.", "filingDueDate": "2026-01-20T00:00:00", "transactionalPeriodEnd": "2025-12-31T00:00:00", "transactionalPeriodStart": "2025-01-01T00:00:00" }, { "description": "Annually filing for January 2026, due January 20 2027.", "filingDueDate": "2027-01-20T00:00:00", "transactionalPeriodEnd": "2026-12-31T00:00:00", "transactionalPeriodStart": "2026-01-01T00:00:00" } ] }, { "code": "O", "filingFrequency": "Occasional", "filingFrequencyId": 14, "legacyFilingFrequencyId": 6, "frequencyTrigger": "If you engage in business for 8 months or less during each year, you may indicate the months in which you plan to conduct business when registering.", "startDay": 0, "endDay": 0, "filingPeriodDates": [ { "description": "Monthly filing for April 2025, due May 20 2025; file only when I have sales.", "filingDueDate": "2025-05-20T00:00:00", "transactionalPeriodEnd": "2025-04-30T00:00:00", "transactionalPeriodStart": "2025-04-01T00:00:00" }, { "description": "Monthly filing for May 2025, due June 20 2025; file only when I have sales.", "filingDueDate": "2025-06-20T00:00:00", "transactionalPeriodEnd": "2025-05-31T00:00:00", "transactionalPeriodStart": "2025-05-01T00:00:00" }, { "description": "Monthly filing for June 2025, due July 20 2025; file only when I have sales.", "filingDueDate": "2025-07-20T00:00:00", "transactionalPeriodEnd": "2025-06-30T00:00:00", "transactionalPeriodStart": "2025-06-01T00:00:00" }, { "description": "Monthly filing for July 2025, due August 20 2025; file only when I have sales.", "filingDueDate": "2025-08-20T00:00:00", "transactionalPeriodEnd": "2025-07-31T00:00:00", "transactionalPeriodStart": "2025-07-01T00:00:00" }, { "description": "Monthly filing for August 2025, due September 20 2025; file only when I have sales.", "filingDueDate": "2025-09-20T00:00:00", "transactionalPeriodEnd": "2025-08-31T00:00:00", "transactionalPeriodStart": "2025-08-01T00:00:00" }, { "description": "Monthly filing for September 2025, due October 20 2025; file only when I have sales.", "filingDueDate": "2025-10-20T00:00:00", "transactionalPeriodEnd": "2025-09-30T00:00:00", "transactionalPeriodStart": "2025-09-01T00:00:00" }, { "description": "Monthly filing for October 2025, due November 20 2025; file only when I have sales.", "filingDueDate": "2025-11-20T00:00:00", "transactionalPeriodEnd": "2025-10-31T00:00:00", "transactionalPeriodStart": "2025-10-01T00:00:00" }, { "description": "Monthly filing for November 2025, due December 20 2025; file only when I have sales.", "filingDueDate": "2025-12-20T00:00:00", "transactionalPeriodEnd": "2025-11-30T00:00:00", "transactionalPeriodStart": "2025-11-01T00:00:00" }, { "description": "Monthly filing for December 2025, due January 20 2026; file only when I have sales.", "filingDueDate": "2026-01-20T00:00:00", "transactionalPeriodEnd": "2025-12-31T00:00:00", "transactionalPeriodStart": "2025-12-01T00:00:00" }, { "description": "Monthly filing for January 2026, due February 20 2026; file only when I have sales.", "filingDueDate": "2026-02-20T00:00:00", "transactionalPeriodEnd": "2026-01-31T00:00:00", "transactionalPeriodStart": "2026-01-01T00:00:00" }, { "description": "Monthly filing for February 2026, due March 20 2026; file only when I have sales.", "filingDueDate": "2026-03-20T00:00:00", "transactionalPeriodEnd": "2026-02-28T00:00:00", "transactionalPeriodStart": "2026-02-01T00:00:00" }, { "description": "Monthly filing for March 2026, due April 20 2026; file only when I have sales.", "filingDueDate": "2026-04-20T00:00:00", "transactionalPeriodEnd": "2026-03-31T00:00:00", "transactionalPeriodStart": "2026-03-01T00:00:00" }, { "description": "Monthly filing for April 2026, due May 20 2026; file only when I have sales.", "filingDueDate": "2026-05-20T00:00:00", "transactionalPeriodEnd": "2026-04-30T00:00:00", "transactionalPeriodStart": "2026-04-01T00:00:00" }, { "description": "Monthly filing for May 2026, due June 20 2026; file only when I have sales.", "filingDueDate": "2026-06-20T00:00:00", "transactionalPeriodEnd": "2026-05-31T00:00:00", "transactionalPeriodStart": "2026-05-01T00:00:00" }, { "description": "Monthly filing for June 2026, due July 20 2026; file only when I have sales.", "filingDueDate": "2026-07-20T00:00:00", "transactionalPeriodEnd": "2026-06-30T00:00:00", "transactionalPeriodStart": "2026-06-01T00:00:00" }, { "description": "Monthly filing for July 2026, due August 20 2026; file only when I have sales.", "filingDueDate": "2026-08-20T00:00:00", "transactionalPeriodEnd": "2026-07-31T00:00:00", "transactionalPeriodStart": "2026-07-01T00:00:00" }, { "description": "Monthly filing for August 2026, due September 20 2026; file only when I have sales.", "filingDueDate": "2026-09-20T00:00:00", "transactionalPeriodEnd": "2026-08-31T00:00:00", "transactionalPeriodStart": "2026-08-01T00:00:00" }, { "description": "Monthly filing for September 2026, due October 20 2026; file only when I have sales.", "filingDueDate": "2026-10-20T00:00:00", "transactionalPeriodEnd": "2026-09-30T00:00:00", "transactionalPeriodStart": "2026-09-01T00:00:00" }, { "description": "Monthly filing for October 2026, due November 20 2026; file only when I have sales.", "filingDueDate": "2026-11-20T00:00:00", "transactionalPeriodEnd": "2026-10-31T00:00:00", "transactionalPeriodStart": "2026-10-01T00:00:00" }, { "description": "Monthly filing for November 2026, due December 20 2026; file only when I have sales.", "filingDueDate": "2026-12-20T00:00:00", "transactionalPeriodEnd": "2026-11-30T00:00:00", "transactionalPeriodStart": "2026-11-01T00:00:00" }, { "description": "Monthly filing for December 2026, due January 20 2027; file only when I have sales.", "filingDueDate": "2027-01-20T00:00:00", "transactionalPeriodEnd": "2026-12-31T00:00:00", "transactionalPeriodStart": "2026-12-01T00:00:00" }, { "description": "Monthly filing for January 2027, due February 20 2027; file only when I have sales.", "filingDueDate": "2027-02-20T00:00:00", "transactionalPeriodEnd": "2027-01-31T00:00:00", "transactionalPeriodStart": "2027-01-01T00:00:00" }, { "description": "Monthly filing for February 2027, due March 20 2027; file only when I have sales.", "filingDueDate": "2027-03-20T00:00:00", "transactionalPeriodEnd": "2027-02-28T00:00:00", "transactionalPeriodStart": "2027-02-01T00:00:00" }, { "description": "Monthly filing for March 2027, due April 20 2027; file only when I have sales.", "filingDueDate": "2027-04-20T00:00:00", "transactionalPeriodEnd": "2027-03-31T00:00:00", "transactionalPeriodStart": "2027-03-01T00:00:00" } ] } ] } } } } } } ```